✉ 捨てメアド

オープン 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/eventsSSE イベントストリーム。新着時に 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": "…"}

← ホームに戻る