オープン API
シンプルな HTTP API で一時受信箱を作成し、メールを読み取れます。自動テストや会員登録の検証に最適です。すべてのエンドポイントは JSON を返します。
認証
受信箱を作成するとトークンが返されます。以降のリクエストで送信してください:
Authorization: Bearer <token>
レート制限
API キーなしの場合、各 IP は 1 分あたり最大 10 個の受信箱を作成できます。上限を引き上げるには、作成時に API キーを送信してください:
X-API-Key: tm_xxxxxxxxxxxxxxxx
エンドポイント
| メソッド | パス | 説明 |
|---|---|---|
| GET | /api/domains | 利用可能なドメイン一覧 |
| POST | /api/mailbox | 受信箱を作成。空のボディでランダムなアドレス、または {"local":"abc","domain":"…"} で指定アドレス |
| GET | /api/mailbox | 現在の受信箱の情報 |
| DELETE | /api/mailbox | 受信箱とすべてのメールを削除 |
| GET | /api/messages | 受信箱一覧(最新 100 件) |
| GET | /api/messages/{id} | メールを取得(本文と添付ファイル一覧) |
| DELETE | /api/messages/{id} | メールを削除 |
| GET | /api/messages/{id}/raw | 元の .eml をダウンロード |
| GET | /api/attachments/{id} | 添付ファイルをダウンロード |
| GET | /api/events | SSE イベントストリーム。新着時に event: mail を送信 |
例
# 1. 受信箱を作成。空のボディでランダムなアドレス、または {"local":"abc","domain":"…"} で指定アドレス
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. 受信箱一覧(最新 100 件)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. メールを取得(本文と添付ファイル一覧)
curl -s https://www.temp-mail.cc/api/messages/123 \
-H 'Authorization: Bearer <token>'
# Python
import requests, time
base = "https://www.temp-mail.cc"
mb = requests.post(f"{base}/api/mailbox", json={}).json()
headers = {"Authorization": f"Bearer {mb['token']}"}
print(mb["address"])
while True:
msgs = requests.get(f"{base}/api/messages", headers=headers).json()["messages"]
if msgs:
print(requests.get(f"{base}/api/messages/{msgs[0]['id']}", headers=headers).json()["text"])
break
time.sleep(3)
エラー
エラー時は 2xx 以外のステータスと JSON ボディが返されます:
{"error": "rate_limited", "message": "…"}