API Reference
받은 메일의 첨부 내려받기
받은 메일에 붙어 있던 첨부 파일 하나를 내려받습니다. attachmentId 는 단건 조회
응답의 attachments[].attachmentId 입니다.
응답은 파일 자체입니다. 내부적으로는 단기 내려받기 링크로 한 번 이동(302) 하지만
대부분의 HTTP 클라이언트가 자동으로 따라가므로 별도 처리는 필요 없습니다.
(curl 은 -L 이 필요합니다.) 크기 제한은 없습니다.
⭐ 단건 조회 응답의 attachments[].downloadUrl 로도 같은 파일을 받을 수 있습니다.
그쪽은 인증이 필요 없어 <img src> 에 그대로 넣을 수 있는 반면 잠시 뒤 만료되고,
이 API 는 인증이 필요한 대신 언제든 다시 부를 수 있습니다.
파일명
원래 파일명이 그대로 붙습니다(한글 파일명 포함).
⚠️ 이 파일명은 보낸 사람이 정한 값입니다. 저장 경로로 그대로 쓰지 마십시오.
보관기간
보관기간이 지난 뒤에는 410 입니다. 메일 기록 자체는 남아 있으므로 단건 조회는 계속
동작합니다 — 사라진 것은 첨부 내용뿐입니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
emailId*string
받은 메일의 emailId.
attachmentId*string
단건 조회 응답의 attachments[].attachmentId.
Response Body
application/octet-stream
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/emails/clx9eml00001/attachments/clx9att00001"Empty
{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}