이메일 단건 조회 (본문 포함)

ClawOps 이메일 리소스 ID.

outbound 는 이 계정이 보낸 메일, inbound 는 이 계정의 수신 도메인으로 들어온 메일입니다.

보낸 메일은 sent(공급자 접수) 또는 failed 입니다 — sent 는 접수됐다는 뜻이지 수신함 도착이 아닙니다. 받은 메일은 항상 received 입니다.

보낸 메일에서는 과금 단위입니다 — 실제로 발송한 To+Cc+Bcc 의 합계이며 한 통을 3명에게 보내면 3입니다. 수신거부로 빠진 주소는 세지 않습니다(suppressed 참고). 받은 메일에서는 이 계정에 실제로 배달된 주소 수(recipients 의 길이)입니다.

본문이 상한(각 1MiB)에 걸려 잘렸는지. 잘린 경우에도 원문에는 전부 있으므로 raw.downloadUrl 로 받아 직접 해석할 수 있습니다.

수신거부 명단에 있어 이 발송에서 빠진 주소들. 요청한 표기 그대로 돌려줍니다.

⚠️ 이메일은 차단된 수신자가 있어도 나머지에게는 보냅니다(전화·문자가 발신 전체를 거절하는 것과 다릅니다). 그래서 201 을 받고도 일부가 안 갔을 수 있고, 이 칸이 그걸 알려주는 유일한 자리입니다. 비어 있으면 아무도 빠지지 않았다는 뜻입니다.

recipientCount 에는 포함되지 않습니다 — 요청한 수신자 수는 recipientCount + suppressed.length 입니다. 받은 메일에서는 항상 빈 배열입니다.

실패 사유 코드. status 가 sent 면 null 입니다.

provider_unavailable 은 공급자를 부르지 못한 경우이고, 그 밖의 값은 공급자가 거절한 경우입니다.

사람이 읽는 실패 설명. status 가 sent 면 null 입니다.

답장 주소(Reply-To). 받은 메일은 발신자가 지정한 주소, 보낸 메일은 발송할 때 지정한 값입니다.

⭐ 답장은 from 이 아니라 이 주소로 보내십시오. 비어 있을 때만 from 이 답장 주소입니다(RFC 5322 §3.6.2). 뉴스레터·티켓 시스템은 대부분 이 값을 다르게 둡니다.

이 메일 자신의 Message-ID(꺾쇠 < > 제외). 답장할 때 inReplyTo 에 그대로 넣는 값입니다.

⛔ 보낸 메일은 항상 null 입니다. 이 헤더는 공급자가 발급하며 우리가 지정한 값을 덮어쓰기 때문에 우리도 그 값을 모릅니다. ⚠️ 받은 메일도 null 일 수 있습니다 — 이 헤더는 RFC 상 필수가 아니고, 붙이지 않고 보내는 발신자가 실제로 있습니다. 그 메일에는 스레드로 답장할 수 없습니다.

이 메일이 답장한 원본의 Message-ID(꺾쇠 제외). 답장이 아니면 null 입니다.

대화의 조상 사슬. 오래된 것이 앞입니다. 다음 답장에 넘길 값은 [...references, messageId] 입니다.

⚠️ 보낸 메일의 값은 요청하신 목록이 아니라 실제로 헤더에 실어 보낸 목록입니다. 긴 대화는 공급자 헤더 길이 상한 때문에 RFC 5537 §3.4.4 에 따라 첫 항목과 최근 항목만 남기고 줄여 보냅니다.

실제로 이 계정에 배달된 주소. 받은 메일에만 있습니다(보낸 메일은 null).

⚠️ to 를 보고 라우팅하지 마십시오. 숨은 참조(BCC)로 온 메일은 to 에 그 주소가 없습니다 — 이 필드에만 있습니다. 한 도메인에 support@·sales@ 처럼 여러 주소를 두고 처리를 나눈다면 반드시 이 값을 쓰십시오.

공급자가 메일을 받은 시각. 받은 메일에만 있습니다.

받은 메일의 원문 크기(바이트). ⚠️ 공급자가 덧붙인 헤더(약 3.6KB)가 포함된 값이라 메일 클라이언트가 보여 주는 크기와 다를 수 있습니다. 과금은 이 값 기준입니다.

공급자의 스팸·바이러스·인증 판정. 받은 메일에만 있습니다.

⚠️ 값은 공급자 원문 그대로입니다(PASS·FAIL·GRAY·PROCESSING_FAILED 등). 우리가 해석하지 않으므로 목록이 늘어날 수 있습니다 — 모르는 값을 만나면 안전한 쪽으로 처리하십시오.

⛔ from 만 믿고 자동 처리하지 마십시오. 발신자는 위조될 수 있고, 그걸 판별하라고 spf·dkim·dmarc 를 함께 드립니다.

받은 메일의 본문 해석 결과. unparsable 이면 본문을 읽지 못한 것이며, 그때도 원문은 그대로 보관되어 단건 조회의 raw 로 받을 수 있습니다.

평문 본문. 받은 메일에만 있습니다.

보관기간이 지났거나 본문을 해석하지 못한 경우 null 입니다 — 그때도 발신자·제목· 시각 같은 메타데이터는 그대로 조회됩니다.

HTML 본문. 받은 메일에만 있습니다.

⛔ 이 HTML 은 외부인이 보낸 것이며 우리가 소독(sanitize)하지 않습니다. 원문을 손실 없이 전달하는 것이 이 API 의 계약이므로, 그대로 화면에 렌더하면 스크립트 삽입(XSS)에 노출됩니다. 표시하려면 여러분 쪽에서 정제하십시오.

본문 안의 이미지

HTML 메일의 이미지는 첨부로 실려 오고 본문은 <img src="cid:로고"> 처럼 그것을 가리킵니다. 그대로 렌더하면 이미지가 깨지므로, cid: 뒤의 값과 같은 contentId 를 가진 첨부를 찾아 그 downloadUrl 로 바꿔 넣으십시오. 그 URL 은 인증이 필요 없어 브라우저에서 바로 표시됩니다.

첨부 목록. 받은 메일에만 있습니다.

원문(MIME) 전체를 내려받는 단기 링크입니다. 받은 메일에만 있고, 보관기간이 지나면 null 입니다.

본문이 잘렸거나(bodyTruncated) 우리가 해석하지 못한 메일도 원문에는 전부 있습니다.

⚠️ 이 URL 은 인증을 거치지 않습니다 — 가진 사람은 누구나 받을 수 있으니 로그나 외부에 남기지 마십시오. 그리고 저장해 두고 나중에 쓰지 마십시오: expiresAt 이후에는 동작하지 않습니다.