開發者

運用 TempMail API 進行開發

透過 HTTP 建立信箱並讀取驗證碼。無需帳號即可立即開始使用,或建立 API 金鑰解鎖 Pro 功能。

無需登入・無需 API 金鑰

立即匿名開始

與支援 TempMail 網頁應用程式相同的 API。每個信箱都會獲得一個隨機地址,並可保留 24 小時。

  1. 1POST /accounts 建立包含隨機地址與密碼的信箱。
  2. 2POST /token 以地址與密碼換取 tm_box_ 信箱權杖。
  3. 3GET /messages 回傳收到的郵件,並已預先擷取驗證碼。
BASE=https://www.tempmail.ai/api/v1

# 1. Create a mailbox (random address + password)
curl -s -X POST "$BASE/accounts" \
  -H "Content-Type: application/json" -d '{}'
# {"id":"…","address":"k3x9m2q7…@tempmail.ai","password":"…","expires_at":"…"}

# 2. Exchange the credentials for a mailbox token
curl -s -X POST "$BASE/token" \
  -H "Content-Type: application/json" \
  -d '{"address":"ADDRESS","password":"PASSWORD"}'
# {"id":"…","token":"tm_box_…","token_type":"Bearer","expires_at":"…"}

# 3. Read messages – verification codes are already extracted
curl -s "$BASE/messages" -H "Authorization: Bearer TOKEN"
# {"items":[{"from":"[email protected]","subject":"Your verification code","verification_code":"482913",…}],"total":1,…}
閱讀完整 API 參考文件
Pro

用於 Pro 功能的 API 金鑰

tm_live_ API 金鑰繫結至您的 TempMail 帳號。當您的帳號為 Pro 方案時,同一把金鑰會自動解鎖:

  • 自訂地址:附帶您的金鑰與 "address" 欄位發送 POST /accounts
  • 更寬裕的上限:每秒 20 次請求與每日 1000 個新信箱
  • 最多 10 個永不過期的專屬地址
  • 30 天郵件保留期與 100 MB 儲存空間

免費帳號也可以建立金鑰。在升級之前,其運作方式與匿名 API 相同,日後升級無需修改程式碼。