임시 이메일 API

개발자를 위한 통합 REST API: temp mail 주소 생성, 실제 이메일 수신.

Mail.td는 개발자를 위한 이메일 인프라입니다. 통합 REST API로 temporary email 주소를 생성하고, 실제 이메일을 수신하며, 새 메시지를 WebSocket 또는 서명된 Webhook으로 실시간 전달합니다. API는 무료로 시작할 수 있으며 — 모든 HTTP 클라이언트와 호환됩니다. Selenium, Cypress, Playwright, Puppeteer 테스트, CI/CD 파이프라인, 또는 자체 backend에서 직접 호출하세요.

워크플로

메일박스를 생성하고, SMTP로 실제 이메일을 수신한 뒤, REST API로 메시지를 읽으세요. 메일박스는 7일 후 자동으로 만료됩니다.

# 1. Create a mailbox
$ curl -X POST https://api.mail.td/api/accounts \
    -H "Authorization: Bearer td_xxx" \
    -d '{"address":"user@mail.td","password":"secret"}'
→ { "id": "a1b2c3d4-...", "address": "user@mail.td" }

# 2. List incoming messages
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages \
    -H "Authorization: Bearer td_xxx"
→ { "messages": [ { "id": "f5e6d7c8-...", "from": "...", "subject": "...", "created_at": "..." } ] }

# 3. Read a message
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages/f5e6d7c8-... \
    -H "Authorization: Bearer td_xxx"
→ { "from": "...", "subject": "...", "text_body": "...", "html_body": "...", "attachments": [...] }

SDK 및 클라이언트 라이브러리

Mail.td는 세 가지 언어의 공식 SDK를 제공합니다. 각 클라이언트는 타입이 지정된 응답과 오류 처리로 REST API를 완전히 커버합니다 — 설치하고 Pro API Token으로 인증한 뒤 바로 사용할 수 있습니다.

Node.js / TypeScript

npm install mailtd

네이티브 fetch를 사용하는 의존성 없는 클라이언트, 완전한 TypeScript 타입 정의 포함.

Python

pip install mailtd

HTTP 기반 클라이언트, dataclass 타입과 async context manager 지원.

Go

go get github.com/mailtd/mailtd-go

stdlib만 사용, context 기반 요청 생명주기, 완전한 타입 struct.

중요 참고 사항 Pro 플랜의 이메일은 7일간 보관 후 자동 삭제됩니다(무료 플랜의 보관 기간은 가격 페이지를 참조하세요). Mail.td는 이메일 테스트, QA 자동화, 개발자 임시 사용을 위해 설계되었으며 — 장기 메일박스 용도는 아닙니다.