DustMail API 시작하기

DustMail API를 사용하면 임시 이메일 주소를 자동 생성하고 메일을 수신할 수 있습니다. 이는 자동화 테스트 작성, CI/CD 파이프라인 연동, 개인정보 보호 관련 앱 개발에 매우 이상적입니다. 이 가이드는 cURL, Node.js, Python 실무 예제를 바탕으로 모든 주요 API 엔드포인트를 다룹니다.

인증 (Authentication)

모든 API 요청에는 API 키가 필수적입니다. 대시보드에서 API 키를 생성한 후 다음과 같이 Authorization 헤더로 전송해 주세요.

Authorization: Bearer dm_live_your_api_key

임시 편지함 생성 (Creating an Inbox)

새 임시 이메일 주소를 만드려면 다음 엔드포인트로 POST 요청을 보냅니다.

POST https://dustmail.net/api/v1/inbox

cURL 예제

curl -X POST https://dustmail.net/api/v1/inbox \
  -H "Authorization: Bearer dm_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"duration": 30}'

새 이메일 수신 확인 (Polling)

편지함을 생성한 후, 새로운 메일이 수신되었는지 주기적으로 엔드포인트를 호출하여 확인합니다.

GET https://dustmail.net/api/v1/inbox/YOUR_INBOX_ID

API 호출 제한 (Rate Limits)

무료 계정은 **일일 최대 100회**의 API 호출이 가능하며, 이는 간단한 테스트에 충분합니다. Premium 요금제는 **무제한 API 호출**을 제공합니다. 요금제 페이지에서 업그레이드할 수 있습니다.

주요 사용 사례 (Use Cases)

• E2E 테스트 - 회원가입 및 이메일 인증 플로우 검증 자동화
• CI/CD 파이프라인 - 배포 자동화 과정에서 메일 발송 검증
• 개인정보 보호 앱 - 제품 내에 일회용 이메일 기능을 직접 구현