빠른 시작
발신 도메인을 인증한 뒤 SMTP 또는 Email API로 이메일 발송을 연동하세요.
1. 시작 전 준비
이메일 인증이 완료된 계정, DNS를 관리할 수 있는 도메인과 현재 패키지 정보를 준비하세요. 도메인 추가에는 활성 패키지가 필요합니다. 한도는 실제 계정 설정을 확인하세요. 이 페이지는 로그인, 구매 또는 실제 발송을 수행하지 않습니다.
2. 도메인 추가 및 인증
콘솔에서 ASCII 도메인을 추가하고 dns_records에 반환된 DKIM 및 SPF TXT 값을 설정하세요. DNS 전파 후 인증을 요청하고 all_passed와 각 checks를 확인하세요. HTTP 200만으로 인증 완료를 판단할 수 없습니다. 인증된 발신 도메인만 사용 가능합니다.
curl -X POST "${SMTPDOG_API_ORIGIN}/domains" \
-H "Authorization: Bearer ${SMTPDOG_SESSION_TOKEN}" \
-H "Content-Type: application/json" \
--data '{"domain_name":"example.com"}'3. 발송 자격 증명 생성
API Key 생성 직후 전체 key를 안전하게 보관하세요. 이후 목록에는 메타데이터만 표시됩니다. 도메인 범위 지정을 권장합니다. 발송에는 API Key, 관리에는 세션 토큰을 사용합니다. 서로 혼용하거나 브라우저 및 공개 저장소에 키를 넣지 마세요.
4. 연동 방식 선택
Email API는 표준 HTTP 요청으로 message_id를 반환합니다. SMTP는 TLS를 지원하는 표준 클라이언트를 사용하며 메시지당 수신자 1명만 허용합니다. 환경변수 이름은 문서용 예시로 백엔드 설정 키가 아닙니다. 확인된 실제 연동 정보를 설정하세요.
curl -X POST "${SMTPDOG_API_ORIGIN}/v1/mail/send" \
-H "Authorization: Bearer ${SMTPDOG_API_KEY}" \
-H "Content-Type: application/json" \
--data '{
"from": "sender@example.com",
"to": "recipient@example.com",
"subject": "Welcome to your product",
"text": "Your message goes here."
}'5. 접수 결과 이해
HTTP 202와 queued는 요청 접수 및 대기열 등록만 의미합니다. message_id로 상태를 조회하거나 Webhook을 수신하세요. sent도 받은편지함 도착이나 열람을 보장하지 않습니다. 발송 멱등성 프로토콜이 없으므로 시간 초과 요청을 무조건 재전송하지 마세요.