Tmailor Open API

用於測試與自動化的臨時郵件 API

從你的程式碼建立僅能收信的臨時電子郵件地址,並以 JSON 格式讀取收到的郵件。每個地址都會保留在你的 Tmailor 帳戶中,直到你將其刪除;API 也會回傳在郵件中找到的一次性驗證碼。

最後更新:October 2026

查看方案與限制

  • REST 與 JSON
  • SDK、CLI 與 MCP 伺服器
  • 每月 100 個免費信箱
  • 僅限接收,訊息保留 24 小時
export TMAILOR_API_KEY="tmk_live_..."

# returns 201 with email, token, web.reuse_url
curl -s -X POST https://open-api.tmailor.com/v1/mailboxes \
  -H "Authorization: Bearer $TMAILOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

建立地址,等待郵件,讀取驗證碼。

按信箱數量付費,而非按請求次數

只有建立地址會佔用你的信箱配額。列出地址、查看收件匣、閱讀或刪除訊息都不會佔用。付費方案沒有每日或每月的請求配額,只有每分鐘的速率限制。

範例:一個建立一個地址並檢查收件匣 25 次的 OTP 測試,只會用掉一個信箱。

從 API 金鑰到收件匣,四個步驟

  1. 建立 API 金鑰

    使用你的 tmailor.com 帳號或 Google 登入 API 平台並建立金鑰。在免費方案中,還需新增一個會呼叫 API 的伺服器 IP 位址。

  2. 建立地址

    送出一個請求,即可取得共享網域上的隨機地址,或在你擁有且已驗證的網域上選擇自訂名稱。

  3. 讀取訊息

    列出收件匣,並以 JSON 格式讀取每則訊息:寄件者、主旨、文字、清理過的 HTML,以及 API 找到的一次性驗證碼和連結。

  4. 保留或刪除

    地址不會過期。使用重複使用連結在 tmailor.com 開啟同一個收件匣,或在測試結束後刪除該地址。

專為可重複執行的電子郵件工作流程打造

讓每次測試都有專屬的收件匣,不必共用同一個真實信箱。

註冊與 OTP 測試

每次註冊、重設密碼或驗證一次性驗證碼時,建立全新的地址,再從回應中讀取驗證碼。

CI/CD 管線

在管線中執行端對端郵件檢查,並將金鑰存放在環境變數中。付費方案可接受來自任何 IP 位址的請求。

QA 與預備環境

為測試人員和預備環境提供專屬地址,讓真實收件匣不會混入測試資料。

使用自有網域的地址

新增a domain you own,將其 MX 記錄指向我們,並建立符合命名規則的自訂名稱地址。

方案與價格

選擇你需要的信箱數量。你的額度每 30 天重置一次,年繳方案也一樣。

免費

試用 API,執行小型專案。

$0 /月

  • 每 30 天 100 個信箱
  • 每分鐘最多 30 次請求
  • 每天 2,000 次請求
  • 僅限一個允許清單 IP 發起的呼叫
  • 共享網域與自有網域
免費開始

入門

適合單一開發者或小型測試套件。

$9 /月

  • 每 30 天 3,000 個信箱
  • 每分鐘最多 300 次請求
  • 每日或每月請求數無上限
  • 可從任何 IP 位址發起呼叫
  • 共享網域與自有網域
選擇 入門

Pro

適合每天執行測試的團隊。

$29 /月

  • 每 30 天 30,000 個信箱
  • 每分鐘最多 600 次請求
  • 每日或每月請求數無上限
  • 可從任何 IP 位址發起呼叫
  • 共享網域與自有網域
選擇 Pro

商務

適合每日自動化用量大的公司。

$99 /月

  • 每 30 天 150,000 個信箱
  • 每分鐘最多 2,000 次請求
  • 每日或每月請求數無上限
  • 可從任何 IP 位址發起呼叫
  • 共享網域與自有網域
選擇 商務

Scale

適合大型測試叢集與高負載管線。

$199 /月

  • 每 30 天 400,000 個信箱
  • 每分鐘最多 4,000 次請求
  • 每日或每月請求數無上限
  • 可從任何 IP 位址發起呼叫
  • 共享網域與自有網域
選擇 Scale

Enterprise

適合需要最高信箱量與請求速率的客戶。

$499 /月

  • 每 30 天 2,000,000 個信箱
  • 每分鐘最多 6,000 次請求
  • 每日或每月請求數無上限
  • 可從任何 IP 位址發起呼叫
  • 共享網域與自有網域
選擇 Enterprise

比較方案

這些限制因方案而異,其餘功能所有方案皆相同。

比較方案
方案 免費入門Pro商務ScaleEnterprise
月繳價格$0$9$29$99$199$499
年繳價格$0$90$290$990$1,990$4,990
每 30 天可建立的信箱數1003,00030,000150,000400,0002,000,000
每分鐘請求數303006002,0004,0006,000
每日請求上限2,000無上限無上限無上限無上限無上限
IP 允許清單必須,1 個 IP不需要不需要不需要不需要不需要
託管 MCP 伺服器僅限本機伺服器包含包含包含包含包含

左右滑動即可比較所有方案。

所有方案皆包含

  • 提供 JSON 回應的 REST API
  • 共享網域上的隨機地址
  • 在你自己的已驗證網域上使用自訂名稱
  • 自有網域數量不限(最多可同時有 3 個等待驗證)
  • 地址不會過期
  • 保留的地址數量沒有限制
  • 訊息會保留 24 小時
  • 一次性驗證碼與連結擷取(盡力而為)
  • 可在 tmailor.com 開啟收件匣的重複使用連結
  • 官方 SDK 與命令列工具
  • 方案可合併使用,限制會累加
  • 僅接收,不含附件
  • 刪除地址不會退還配額
  • 當信箱額度用盡後,必須等到下一個週期或升級方案才能建立新地址。現有的收件匣仍可正常使用。
  • 依據 API 條款,付款恕不退還。請先在免費方案上測試你的整合。

官方 SDK 與 CLI

用你慣用的語言呼叫 API,享有具型別的資料模型、自動重試,以及會等待下一封訊息的輔助工具。每個 SDK 都遵循相同的 API,並共用相同的測試情境。

Python

已推出

Python 3.9+

pip install tmailor-sdk

包含 tmailor 命令列工具。

Node.js

已推出

Node.js 18+, TypeScript types

npm install tmailor

PHP

已推出

PHP 8.1+

composer require tmailor/tmailor

給 AI 代理

供 AI 代理使用的 MCP 伺服器

讓 Claude、Cursor、VS Code Copilot 及其他 MCP 用戶端測試你擁有或獲准測試的註冊流程:代理會建立一個真實且僅能接收的地址,等待電子郵件並讀取一次性驗證碼或驗證連結。

這兩種方式都為代理提供相同的工具:建立地址、等待郵件並取得其一次性驗證碼和連結、讀取訊息、刪除地址以及檢查你的配額。代理只會看到電子郵件地址,永遠看不到其背後的 token,且使用與 API 相同的信箱配額和速率限制。

託管伺服器

無需安裝

https://mcp.tmailor.com/mcp

將伺服器網址加到你的 AI 應用程式。支援登入的應用程式(例如 Claude、ChatGPT 和 Codex)會引導你前往 Tmailor 平台核准存取。其他用戶端則在 Authorization 標頭中傳送你的 API 金鑰。

需要有效的付費方案。由於請求來自我們的伺服器,因此你不需要設定 IP 允許清單。

# Claude: add a custom connector with this URL,
# then approve access on the Tmailor platform
https://mcp.tmailor.com/mcp

# Claude Code, with your API key
claude mcp add --transport http tmailor \
  https://mcp.tmailor.com/mcp \
  --header "Authorization: Bearer tmk_live_..."

# Codex CLI, with your API key
export TMAILOR_API_KEY=tmk_live_...
codex mcp add tmailor \
  --url https://mcp.tmailor.com/mcp \
  --bearer-token-env-var TMAILOR_API_KEY

# Cursor (~/.cursor/mcp.json)
{"mcpServers": {"tmailor": {
  "url": "https://mcp.tmailor.com/mcp",
  "headers": {"Authorization": "Bearer tmk_live_..."}}}}

請查看AI connections頁面上的已連接應用程式,並斷開任何一個。斷線的應用程式會在 30 秒內失去存取權限。

本機伺服器

所有方案,包括免費方案

tmailor-mcp

它會在你的電腦上執行,從 TMAILOR_API_KEY 讀取你的金鑰,並需要 uv 或 Python 3.10+。在免費方案中,請將該電腦的 IP 加入允許清單。

# Claude Code
claude mcp add tmailor \
  -e TMAILOR_API_KEY=tmk_live_... \
  -- uvx tmailor-mcp

# Claude Desktop, Cursor, VS Code
#   command: uvx   args: ["tmailor-mcp"]

# without uv
pip install tmailor-mcp

試著問:「建立一個臨時電子郵件,用它在我的測試網站上註冊,然後告訴我驗證碼。」

臨時郵件 API 常見問題

什麼算是一個信箱?

你每建立一個新地址,就會用掉目前 30 天週期額度中的一個信箱。列出、讀取和刪除都不會用掉信箱,而且刪除地址也不會退還信箱。

地址會過期嗎?

不會。地址會一直留在你的帳戶中,直到你刪除它為止。其中的訊息會保留 24 小時。

我可以寄送電子郵件或接收附件嗎?

不行。API 僅供接收,不會傳送附件。

我可以自訂地址名稱和網域嗎?

在我們的共用網域上,名稱是隨機的。若要自訂名稱,請在 API 平台上新增並驗證你擁有的網域,將其 MX 記錄指向我們,然後建立符合命名規則的自訂名稱地址。

我需要設定 IP 允許清單嗎?

僅限免費方案,你需要加入伺服器發出請求時所用的那一個 IP 位址。一個 IP 位址只能屬於一個免費帳號,因此共用的辦公室或 VPN 位址可能已被使用。若使用有效的付費方案,API 可接受來自任何 IP 位址的請求。

API 會幫我讀取驗證碼嗎?

會,但僅盡力而為。當你讀取訊息時,回應會包含它找到的一次性驗證碼(不確定時為 null)、其他類似驗證碼的值以及連結。請務必在你的測試中核對該值。

Claude 或 ChatGPT 等 AI 代理程式可以使用 API 嗎?

可以,透過 MCP。在付費方案中,將託管伺服器 https://mcp.tmailor.com/mcp 加入你的 AI 應用程式並核准存取,或提供你的 API 金鑰。無論哪種方案,你都可以在自己的電腦上執行開源的 tmailor-mcp 伺服器。無論採用哪種方式,代理程式都能建立地址、等待郵件並讀取一次性驗證碼,並使用與 API 相同的信箱配額。

付費方案有請求次數限制嗎?

付費方案沒有每日或每月的請求配額,但每個方案都有每分鐘的速率限制。免費方案另有每日請求上限。

開始使用需要信用卡嗎?

不需要。使用你的 tmailor.com 帳號或 Google 登入,建立金鑰,即可開始使用免費方案。只有選擇付費方案時才需要付款。

我要如何支付方案費用?

可使用 TRC20(Tron)或 BEP20(BNB Smart Chain)網路的 USDT 付款,或使用 Binance Pay。不接受信用卡和簽帳金融卡。方案會在付款確認後生效,通常只需幾分鐘。

我可以退款嗎?

不行。付款恕不退還,因此升級前請先在免費方案上測試你的整合。

API 禁止用於哪些用途?

垃圾郵件、詐騙、在其他服務上大量建立帳號,以及規避其封禁或限制,都違反 API 條款。我們可能會撤銷這類帳戶的 API 金鑰並將其鎖定。

幾分鐘內建立你的第一個地址

從免費方案開始,每月可使用 100 個信箱。無需信用卡。