開放 API
透過簡單的 HTTP 介面建立臨時信箱並讀取郵件,適合自動化測試、註冊流程驗證等情境。所有介面皆回傳 JSON。
驗證
呼叫「建立信箱」介面會回傳 token,之後的請求在標頭中帶上:
Authorization: Bearer <token>
頻率限制
未帶 API Key 時,每個 IP 每分鐘最多建立 10 個信箱。需要更高額度,可在建立信箱時帶上 API Key:
X-API-Key: tm_xxxxxxxxxxxxxxxx
介面列表
| 方法 | 路徑 | 說明 |
|---|---|---|
| GET | /api/domains | 可用網域列表 |
| POST | /api/mailbox | 建立信箱。body 為空則隨機產生,或傳 {"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. 建立信箱。body 為空則隨機產生,或傳 {"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 狀態碼,回應內容為:
{"error": "rate_limited", "message": "…"}