콘텐츠로 이동
adaptmailAPI
한국어

편지 보내기

API 0.16.0OpenAPIllms-full.txt
POST/v1/mailboxes/{mailbox_id}/send

필수 Idempotency-Key 8~128자입니다. 동일한 키와 본문을 사용하여 반복하면 동일한 작업이 반환됩니다. 다른 기관에서는 409를 제공합니다. HTTP 202는 대기열을 의미합니다. 응답 수신 여부가 아닌 작업 상태를 확인하세요.

승인 및 접근 영역 · 오류와 반복

요구

터미널 창
curl -X POST 'https://adapt-mail.com/v1/mailboxes/<mailbox_id>/send' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Idempotency-Key: message-20261019-0001' \
  -H 'Content-Type: application/json' \
  --data '{"to":["[email protected]"],"subject":"Hello","text":"A message from Adapt Mail"}'

옵션

mailbox_idpath반드시

integer

X-Customer-IDheader
옵션 1

string

옵션 2

null

Idempotency-Keyheader반드시

string

minLength: 8

maxLength: 128

요청 본문 · application/json

object

to반드시

array

주요 수신자의 주소입니다.

minItems: 1

maxItems: 50

배열 요소

string

cc

array

다른 참가자에게 표시되는 수신자 주소를 복사합니다.

maxItems: 50

배열 요소

string

bcc

array

숨은참조 수신자 주소.

maxItems: 50

배열 요소

string

subject

string

편지의 제목.

기본: ""

maxLength: 998

text

string

서식을 적용하지 않은 편지의 텍스트입니다.

기본: ""

maxLength: 200000

html

HTML-형식화된 편지 버전입니다.

옵션 1

string

maxLength: 300000

옵션 2

null

file_ids

array

ID 이전에 이 사서함에 다운로드한 파일이 있습니다. 다운로드할 때 또는 파일 목록에서 가져옵니다.

maxItems: 20

배열 요소

string · uuid

forward_message

첨부 파일을 전달해야 하는 원본 이메일입니다.

옵션 1

object

folder반드시

string

폴더 목록의 폴더 이름(예: INBOX.)

minLength: 1

maxLength: 255

uidvalidity반드시

integer

값은 이 폴더에 대한 응답 API의 uidvalidity입니다.

exclusiveMinimum: 0

uid반드시

integer

exclusiveMinimum: 0

알 수 없는 필드는 허용되지 않습니다.

옵션 2

null

reply_to_message_id

답장하려는 이메일의 message_id 값입니다.

옵션 1

string

maxLength: 998

옵션 2

null

references

응답 체인을 저장하기 위한 원본 메시지의 값 references.

옵션 1

string

maxLength: 4000

옵션 2

null

send_at

시간대가 포함된 지연된 디스패치 시간(예: 2026-11-01T12:00:00Z.) 값이 없으면 대기열이 처리될 때 디스패치가 시작됩니다.

옵션 1

string · date-time

옵션 2

null

알 수 없는 필드는 허용되지 않습니다.

응답

202 성공적인 응답

application/json

object

id

string · uuid

상태를 확인하고 보류 중인 제출을 취소하기 위한 작업 ID입니다.

kind

string

mailbox_id
옵션 1

integer

옵션 2

null

status

string

유효한 값: "queued" "running" "succeeded" "failed" "uncertain" "cancelled"

run_at

string

UTC.의 날짜 및 시간 오프셋이 없으면 값은 UTC.도 나타냅니다.

created_at

string

UTC.의 날짜 및 시간 오프셋이 없으면 값은 UTC.도 나타냅니다.

completed_at
옵션 1

string

UTC.의 날짜 및 시간 오프셋이 없으면 값은 UTC.도 나타냅니다.

옵션 2

null

error

작업이 성공적으로 완료되지 않은 경우 오류가 발생하는 이유입니다.

옵션 1

string

옵션 2

null

result

작업 결과입니다. 전송의 경우 수락 및 거부된 수신자에 대한 정보가 포함됩니다.

옵션 1

object

옵션 2

null

400 잘못된 헤더 또는 식별자

application/json

object

detail
옵션 1

string

옵션 2

object

code

string

message

string

옵션 3

array

배열 요소

object

401 로그인이 필요합니다

application/json

object

detail
옵션 1

string

옵션 2

object

code

string

message

string

옵션 3

array

배열 요소

object

403 접근 불가

application/json

object

detail
옵션 1

string

옵션 2

object

code

string

message

string

옵션 3

array

배열 요소

object

404 리소스를 찾을 수 없습니다.

application/json

object

detail
옵션 1

string

옵션 2

object

code

string

message

string

옵션 3

array

배열 요소

object

409 국가 갈등

application/json

object

detail
옵션 1

string

옵션 2

object

code

string

message

string

옵션 3

array

배열 요소

object

413 크기 초과

application/json

object

detail
옵션 1

string

옵션 2

object

code

string

message

string

옵션 3

array

배열 요소

object

422 유효성 검사 오류

application/json

object

detail

array

배열 요소

object

loc반드시

array

배열 요소
옵션 1

string

옵션 2

integer

msg반드시

string

type반드시

string

503 일시적인 이용 불가

application/json

object

detail
옵션 1

string

옵션 2

object

code

string

message

string

옵션 3

array

배열 요소

object

성공적인 제출 결과

작업의 result 필드는 대기열에 대한 응답이 아니라 실행 후입니다.

object

message_id

string

smtp_accepted

boolean

sent_saved

boolean

accepted_recipients

array

배열 요소

string

rejected_recipients

array

배열 요소

object

email

string

code

integer