一時メール API
開発者向け統合 REST API：temp mail アドレスを作成し、本物のメールを受信。
Mail.td は開発者向けのメールインフラです。temporary email アドレスの作成、実メールの受信、WebSocket または署名付き Webhook によるリアルタイム配信を行う統合 REST API を提供します。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 は 3 言語の公式 SDK を提供します。各クライアントは型付きレスポンスとエラーハンドリング付きで REST API を完全にカバー — インストールし、Pro API Token で認証すれば使い始められます。
Node.js / TypeScript
npm install mailtdネイティブ fetch を使うゼロ依存クライアント、完全な TypeScript 型定義付き。
Python
pip install mailtdHTTP ベースのクライアント、dataclass 型と async context manager をサポート。
Go
go get github.com/mailtd/mailtd-gostdlib のみ、context ベースのリクエストライフサイクル、完全に型付けされた struct。