파견 및 운영

site-search,starlight-theme-select{display:none!important}

항해

가이드

방법 API

편지 대기열에 넣기

GET /v1/mailboxes.에서 ID 상자를 받습니다. 한 번의 제출에 대해 고유한 Idempotency-Key을 만들고 최종 결과가 나올 때까지 저장합니다. 네트워크 재생의 경우 동일한 키와 동일한 본문을 사용합니다.

HTTP 202는 배송 확인이 아닌 작업 개체를 반환합니다. id 필드에는 ID 작업이 포함되어 있습니다. 설문 조사 GET /v1/operations/{operation_id}.

POST /v1/mailboxes/42/send
Idempotency-Key: message-20261019-0001
Content-Type: application/json

{"to":["[email protected]"],"subject":"Hello","text":"A message from Adapt Mail"}

결과를 이해하는 방법

queued: 편지가 전송되기를 기다리고 있습니다.
running: 전송이 진행 중입니다.
succeeded: 메일 서버가 제출을 수락했습니다. 각 수신자의 결과를 확인하세요.
failed: 전송에 실패했습니다. 그 이유는 error.에 나와 있습니다.
cancelled: 발송이 취소되었습니다.
uncertain: 전송 결과를 확인하지 못했습니다. 다시 시도하기 전에 작업과 보낸 폴더를 확인하십시오.

전송이 성공한 후 result 필드에는 accepted_recipients - 수락된 수신자, rejected_recipients - 거부된 수신자 및 sent_saved - 전송된 복사본을 저장한 결과가 포함됩니다. 메일 서버가 편지를 수락한다고 해서 수신자의 받은 편지함으로의 배달이 보장되는 것은 아닙니다.

보류 중인 전송을 취소하려면 POST /v1/operations/{operation_id}/cancel.을 실행하십시오. /retry 메소드는 이메일을 다시 보내지 않습니다.

회신, 전달 및 지연 발송

회신하려면 reply_to_message_id에 원본 이메일의 message_id을 포함하여 references.로 전달해 주세요. to에는 reply_to에서 받은 회신 주소 또는 보낸 사람 주소를 입력하세요. 모든 사람에게 답장하려면 자신의 주소를 제외한 다른 참가자를 to 및 cc에 추가하세요.

첨부 파일을 전달하려면 folder, uidvalidity 및 uid.을 사용하여 forward_message을 전달합니다. 업로드된 파일의 경우 file_ids.을 사용합니다. 총 첨부 파일 크기는 25MiB로 제한됩니다.

send_at은 UTC에 저장된 시간대와 함께 지정됩니다. 1년 이내에 배송 연기가 가능합니다. 대기열 생성 시가 아닌 실제 전송 시 제한을 확인합니다.