用于测试与自动化的临时邮件 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 '{}'# pip install tmailor-sdk
from tmailor import Client
with Client() as client: # reads TMAILOR_API_KEY
box = client.mailboxes.create()
print(box.email)
# trigger the email, then wait for it
msg = box.wait_for_message(
timeout=120, since=(box.created_at or 0) - 1)
print(msg.subject, msg.otp(), msg.links())// npm install tmailor
import { Client } from "tmailor";
const client = new Client(); // reads TMAILOR_API_KEY
const box = await client.mailboxes.create();
console.log(box.email);
// trigger the email, then wait for it
const msg = await box.waitForMessage({
timeout: 120_000, since: box.createdAt - 1 });
console.log(msg.subject, msg.otp, msg.links);<?php // composer require tmailor/tmailor
use Tmailor\Client;
$client = new Client(); // reads TMAILOR_API_KEY
$box = $client->mailboxes->create();
echo $box->email, "\n";
// trigger the email, then wait for it
$msg = $box->waitForMessage(
timeout: 120, since: $box->createdAt - 1);
echo $msg->subject, ' ', $msg->otp; 创建地址,等待邮件,读取验证码。
按邮箱数量付费,而非按请求付费
只有创建地址会占用你的邮箱配额。列出地址、查看收件箱以及阅读或删除邮件都不会占用。付费套餐没有每日或每月请求配额,只有每分钟的速率限制。
示例:一个 OTP 测试创建了一个地址并检查收件箱 25 次,只占用一个邮箱。
从 API 密钥到收件箱,只需四步
-
创建 API 密钥
使用你的 tmailor.com 账号或 Google 账号登录 API 平台,并创建一个密钥。在免费套餐中,还需添加唯一一个允许调用 API 的服务器 IP 地址。
-
创建地址
发送一个请求,即可获取共享域名上的随机地址,或在你拥有并已验证的域名上选择自定义名称。
-
读取邮件
列出收件箱,并以 JSON 格式读取每封邮件:发件人、主题、文本、清理后的 HTML,以及 API 找到的一次性代码和链接。
-
保留或删除
地址不会过期。可通过其复用链接在 tmailor.com 上打开同一个收件箱,或在测试完成后删除该地址。
专为可重复的邮件工作流打造
让每次测试运行都有独立的收件箱,而不是共用一个真实邮箱。
注册与 OTP 测试
为每次注册、密码重置或一次性验证码校验创建新地址,然后从响应中读取验证码。
CI/CD 流水线
在流水线中运行端到端邮件检查,密钥通过环境变量传入。付费套餐接受来自任何 IP 地址的请求。
QA 与预发布环境
为测试人员和预发布环境分配各自的地址,让真实收件箱远离测试数据。
使用自有域名的地址
添加你拥有的域名,将其 MX 记录指向我们,并按命名规则创建自定义名称的地址。
套餐与价格
选择你需要的邮箱数量。额度每 30 天重置一次,按年付费的套餐也是如此。
免费
试用 API,运行小型项目。
$0 /月
$0 /月
- 每 30 天 100 个邮箱
- 每分钟最多 30 次请求
- 每天 2,000 次请求
- 仅允许一个白名单 IP 调用
- 共享域名及自有域名
入门
适合单个开发者或小型测试套件。
$9 /月
$90 /年
- 每 30 天 3,000 个邮箱
- 每分钟最多 300 次请求
- 无每日或每月请求配额
- 可从任意 IP 地址调用
- 共享域名及自有域名
Pro
适合每天运行测试的团队。
$29 /月
$290 /年
- 每 30 天 30,000 个邮箱
- 每分钟最多 600 次请求
- 无每日或每月请求配额
- 可从任意 IP 地址调用
- 共享域名及自有域名
商业
适合日常自动化量大的公司。
$99 /月
$990 /年
- 每 30 天 150,000 个邮箱
- 每分钟最多 2,000 次请求
- 无每日或每月请求配额
- 可从任意 IP 地址调用
- 共享域名及自有域名
Scale
适合大规模测试集群和高负载流水线。
$199 /月
$1,990 /年
- 每 30 天 400,000 个邮箱
- 每分钟最多 4,000 次请求
- 无每日或每月请求配额
- 可从任意 IP 地址调用
- 共享域名及自有域名
Enterprise
适合需要最高邮箱量和请求速率的客户。
$499 /月
$4,990 /年
- 每 30 天 2,000,000 个邮箱
- 每分钟最多 6,000 次请求
- 无每日或每月请求配额
- 可从任意 IP 地址调用
- 共享域名及自有域名
套餐对比
这些限制因套餐而异,其余功能在所有套餐中均相同。
| 套餐 | 免费 | 入门 | Pro | 商业 | Scale | Enterprise |
|---|---|---|---|---|---|---|
| 月付价格 | $0 | $9 | $29 | $99 | $199 | $499 |
| 年付价格 | $0 | $90 | $290 | $990 | $1,990 | $4,990 |
| 每 30 天可创建的邮箱数 | 100 | 3,000 | 30,000 | 150,000 | 400,000 | 2,000,000 |
| 每分钟请求数 | 30 | 300 | 600 | 2,000 | 4,000 | 6,000 |
| 每日请求上限 | 2,000 | 无上限 | 无上限 | 无上限 | 无上限 | 无上限 |
| IP 允许列表 | 必需,1 个 IP | 无需 | 无需 | 无需 | 无需 | 无需 |
| 托管 MCP 服务器 | 仅本地服务器 | 包含 | 包含 | 包含 | 包含 | 包含 |
横向滑动可对比所有套餐。
所有套餐均包含
- 返回 JSON 响应的 REST API
- 共享域名上的随机地址
- 在你自己的已验证域名上使用自定义名称
- 自有域名数量不限(最多可同时有 3 个等待验证)
- 地址永不过期
- 保留的地址数量不限
- 消息保留 24 小时
- 一次性验证码和链接提取(尽力而为)
- 用于在 tmailor.com 上打开收件箱的复用链接
- 官方 SDK 和命令行工具
- 套餐可叠加,限制累加
- 仅接收,不含附件
- 删除地址不会返还配额
- 当邮箱配额用尽后,在下一个周期开始或升级套餐之前,无法创建新地址。现有收件箱仍可正常使用。
- 根据API条款,付款不予退还。请先在免费套餐上测试你的集成。
官方 SDK 和 CLI
用你熟悉的语言调用 API,提供类型化模型、自动重试,以及等待下一条消息的辅助工具。所有 SDK 遵循相同的 API,并共用同一套测试场景。
面向 AI 代理的 MCP 服务器
让 Claude、Cursor、VS Code Copilot 及其他 MCP 客户端测试你拥有或获准测试的注册流程:代理会创建一个真实的仅接收地址,等待邮件并读取一次性验证码或验证链接。
两种方式都为代理提供相同的工具:创建地址、等待邮件并获取其一次性验证码和链接、读取邮件、删除地址以及查看配额。代理只能看到邮箱地址,永远看不到其背后的 token,并且使用与 API 相同的邮箱配额和速率限制。
托管服务器
无需安装https://mcp.tmailor.com/mcp
将服务器 URL 添加到你的 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 密钥并锁定账户。