Tovanix

메일 발송 API

자신의 도메인으로 서버 측에서 메일을 발송하며, 콘솔의 「메일 발송」과 할당량·과금·제한을 공유합니다. 발신 주소의 도메인은 연결되어 활성 상태인 발송 도메인과 정확히 일치해야 합니다.

인증: 플랫폼의 다른 공개 API와 같은 사용자 단위 API 키를 사용합니다
메일 발송: POST /api/v1/mail/send. 응답은 수신자별로 묶여 오며 bounced_addrs가 목록 정리의 유일한 근거입니다
멱등 키: Idempotency-Key 헤더를 붙이면 같은 키의 반복 제출은 한 번만 발송되어 중복 전달과 이중 과금을 막습니다
대화 스레드: in_reply_to와 references 전체 체인을 붙여야 답장이 상대방의 원래 대화에 합쳐집니다
할당량 및 도메인: 오늘 남은 양과 사용 가능한 발송 도메인을 조회해 자체 시스템에서 속도를 제한합니다
코드 예제: cURL / Node.js / Python / Go / PHP 최소 동작 예제로, 모두 멱등 키와 하드 바운스 처리를 포함합니다

자주 묻는 질문

HTTP 200이면 모두에게 전달된 건가요?

아닙니다. 결과는 수신자별로 묶이며, 5명에게 보낸 메일이 2건 전달, 1건 대기, 2건 하드 바운스일 수 있습니다. 바운스 콜백이 없으므로 bounced_addrs가 목록 정리의 유일한 근거이며, 해당 주소로의 발송은 즉시 멈춰야 합니다.

Idempotency-Key는 언제 꼭 붙여야 하나요?

호출이 자동으로 재시도될 수 있을 때는 항상 붙여야 합니다(시간 초과 재시도, 작업 큐 재투입, SDK 내장 재시도). 없으면 네트워크가 한 번 흔들리는 것만으로 수신자가 두 통을 받고 과금도 두 번 되며, 둘 다 되돌릴 수 없습니다. 주문 번호 같은 업무 키를 권장합니다.

불러오는 중…