Developers

使用 ChatTempMail API 開發

具備 AI 能力的一次性信箱 — REST API、OpenAPI 3.1 規範、MCP 伺服器、agent skill 與 Webhook。取得 API 金鑰後，一分鐘內就能擁有一個臨時收件匣。

快速入門

三個請求拿到第一個驗證碼。基底 URL：https://chat-tempmail.com。所有端點皆接受 X-API-Key 或 Authorization: Bearer。

1) List available domains

curl https://chat-tempmail.com/api/email/domains \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"

2) Create a disposable address (1 hour)

curl -X POST https://chat-tempmail.com/api/emails/generate \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "test", "expiryTime": 3600000, "domain": "chat-tempmail.com"}'

3) Poll for messages

curl https://chat-tempmail.com/api/emails/{emailId} \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"

機器可讀資源

agent 可以按名稱探索的可預測 URL：

OpenAPI 3.1 規範

完整的 REST API 結構描述，含 operationId、型別化參數與回應結構描述。亦提供於 /api/openapi.json 與 /.well-known/openapi.json。

llms.txt

以 Markdown 呈現的網站與 API 概覽，含 agent 專用的 when-to-use 章節。送出 Accept: text/markdown 即可取得 text/markdown 回應。

MCP 伺服器

讓 Claude、Cursor 與 VS Code 擁有原生工具存取能力。透過 npm 在本機執行：mcp-server-tempmail。

Agent skill

可安裝的 skill，教導編碼 agent 完整的建立收件匣 → 輪詢 → AI 處理工作流程。

CLI 與 MCP 套件

npx mcp-server-tempmail 可作為 CLI 式工具獨立運作；官方 npm 套件。

身分驗證

不需要繁瑣的 OAuth 流程：在個人資料頁建立 API 金鑰，以請求標頭傳送即可。金鑰擁有與帳號相同的權限 — 若外洩請立即重新產生。

1登入並開啟個人資料頁
2建立 API 金鑰（只會顯示一次 — 請妥善保存）
3每個請求都附上 X-API-Key: YOUR_API_KEY（或 Authorization: Bearer YOUR_API_KEY）

X-API-Key: YOUR_API_KEY

Webhook

與其輪詢，不如設定 Webhook（POST /api/webhook），ChatTempMail 會以 X-Webhook-Event: new_message 標頭將每封新郵件 POST 到你的 URL。請快速回應 2xx；傳送失敗會重試，請保持端點的冪等性。

Configure a webhook

curl -X POST https://chat-tempmail.com/api/webhook \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-server.com/webhook", "enabled": true}'

沙盒與速率限制

沒有獨立的沙盒環境：每個帳號都可以免費建立臨時地址。付費方案解鎖 AI 操作（摘要/翻譯/問答/擷取）、永久地址與附件。列表端點每頁回傳 20 筆；分頁採游標式。AI 端點有依角色而定的每日限額，可從 X-AI-Remaining 回應標頭查看。

支援

問題、錯誤回報、功能建議：

GitHub 電子郵件