발송 API 문서

API 하나로 사이트의 가입 인증·비밀번호 재설정·알림 메일 발송 — SMTP 구축 불필요.

API 키 받기

지금 사용 가능 소유권·MX·SPF·DKIM·DMARC는 개별 검증됩니다. 완료되면 API 키로 발송하고, 콘솔에서 수신자별 성공·실패·처리중 결과를 볼 수 있습니다.

빠른 시작

  1. 1

    도메인 연결

    웹사이트 발송에서 발송 도메인을 추가하세요.

  2. 2

    DNS 검증

    SPF / DKIM / DMARC와 인증 TXT 레코드를 추가하고 원클릭으로 검증하세요.

  3. 3

    키 생성

    te_live_ 키를 생성하세요 — 평문은 한 번만 표시되니 그 자리에서 저장하세요.

이메일 보내기

Authorization 헤더에 te_live_ 키를 담은 POST 요청.

curl -X POST https://tutuemail.com/api/sending/send \
  -H "Authorization: Bearer te_live_xxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: signup-user-123" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@your-domain.com",
    "to": "user@example.com",
    "subject": "欢迎注册",
    "html": "<p>点击验证你的邮箱</p>"
  }'

요청 필드

from 발신 주소, 검증된 도메인 하위여야 함
to 수신 주소(단일 또는 배열)
subject 이메일 제목
html / text 이메일 본문(HTML 또는 일반 텍스트)
Idempotency-Key 선택 헤더; 재시도 시 같은 값을 사용해 중복 발송을 방지

수락되면 HTTP 202와 요청 id, accepted 상태를 반환합니다. 같은 API 키로 GET /api/sending/messages/{id} 하면 수신자별 전달/실패/처리중/알수없음을 반환합니다.

오류 및 제한

401 키가 무효이거나 폐기됨 — te_live_ 키 재생성
403 발신 도메인 미검증, 또는 주소가 검증된 도메인 하위가 아님
429 발송 속도 초과; 응답에 retry_after 포함 — 안내대로 나중에 재시도
503 메일 엔진 일시 불가; 동일 Idempotency-Key로 재시도

수신자 수·본문 크기·속도에 보호 상한이 있습니다. 검증 후에만 집계되므로 잘못된 요청은 할당량을 소모하지 않습니다.

연동할 준비 되셨나요?

API 키 받기 FAQ 보기