받은 메일의 첨부 내려받기

받은 메일에 붙어 있던 첨부 파일 하나를 내려받습니다. attachmentId 는 단건 조회 응답의 attachments[].attachmentId 입니다.

응답은 파일 자체입니다. 내부적으로는 단기 내려받기 링크로 한 번 이동(302) 하지만 대부분의 HTTP 클라이언트가 자동으로 따라가므로 별도 처리는 필요 없습니다. (curl 은 -L 이 필요합니다.) 크기 제한은 없습니다.

⭐ 단건 조회 응답의 attachments[].downloadUrl 로도 같은 파일을 받을 수 있습니다. 그쪽은 인증이 필요 없어 <img src> 에 그대로 넣을 수 있는 반면 잠시 뒤 만료되고, 이 API 는 인증이 필요한 대신 언제든 다시 부를 수 있습니다.

파일명

원래 파일명이 그대로 붙습니다(한글 파일명 포함).

⚠️ 이 파일명은 보낸 사람이 정한 값입니다. 저장 경로로 그대로 쓰지 마십시오.

보관기간

보관기간이 지난 뒤에는 410 입니다. 메일 기록 자체는 남아 있으므로 단건 조회는 계속 동작합니다 — 사라진 것은 첨부 내용뿐입니다.