免费方案每天约 50 次请求，无需绑卡
HMAC 签名可以核验的 webhook 投递
OpenAPI 规范有类型。可生成任何客户端。
域名现在用 tail.me，之后用你的域名
POST /email_addresses
一次调用开通地址。邮件以 JSON 回来。
不用去刮一个收件箱。创建地址，然后轮询，或把 webhook 指过去。
- 创建随机地址、指定本地部分，或一次创建一批。
- 入站邮件以 JSON 到达：发件人、主题、正文、附件。
- 任何方案都可以轮询入站列表。Pro 及以上可以加带签名的 webhook。
- Business 及以上可从该地址发出站邮件。更高方案可使用自有域名。
curl -X POST https://app.mailhook.co/api/v1/email_addresses/random \ -H "X-Agent-ID: $AGENT_ID" \ -H "X-API-Key: $API_KEY" \ -H "Content-Type: application/json" \ -d '{"domain_id":"dom_…"}'
# X-Webhook-Signature: HMAC-SHA256 of the raw body { "event": "inbound_email", "data": { "email_address": "[email protected]", "from": "[email protected]", "subject": "Your verification code", "text_body": "Your code is 482913." } }
curl -X POST https://app.mailhook.co/api/v1/outbound_emails \ -H "X-Agent-ID: $AGENT_ID" \ -H "X-API-Key: $API_KEY" \ -H "Content-Type: application/json" \ -d '{"email_address_id":"ea_…","to":"[email protected]","subject":"Received","text_body":"Got it."}'
如何工作
一条线路上的三站。
01 · 开通
开通一个地址
一次 API 调用给代理自己的邮箱地址，用 tail.me 域名或你的域名。
POST /email_addresses
02 · 解析
把邮件变成 JSON
入站邮件被解析为发件人、主题、正文和附件。
inbound_email
03 · 交付
交给你的代理
轮询入站列表，或接收带签名的 webhook。方案包含出站时，可以从同一地址回复。
webhook · poll
现在能做什么
邮件进来。JSON 出去。再寄回去。
给代理的地址、入站 JSON、从同一地址出站，以及你已经拥有的域名。
已上线
入站邮件
每个代理一个地址。发件人、主题、正文和附件，已经解析好。
Webhook
邮件到达时收到带签名的 JSON，从 Pro 起。任何方案都可以轮询。
出站
通过 API 从代理的地址发信，从 Business 起。
自有域名
每个方案都有 tail.me 地址。更高方案可以使用你的域名。
安全
投递有签名。每次调用都带密钥。
每个 webhook 都有 HMAC
对原始正文做 SHA-256，放在 X-Webhook-Signature 头里。重新计算，不匹配就拒绝。
OpenSSL::HMAC.hexdigest("SHA256", secret, raw_body) # header: X-Webhook-Signature
只属于你的 API 密钥
每次调用都发送 X-Agent-ID 和 X-API-Key。地址不是公开收件箱。
-H "X-API-Key: …"
用途
团队把线路用在哪里。
/use-cases/ai-agents
AI 代理
给每个代理一个能收信、也能回信的地址。
查看 →
/use-cases/signup-verification
注册验证
从入站 JSON 里读取验证码或链接。没有人盯着收件箱。
查看 →
/use-cases/qa-testing
QA 与端到端测试
每次运行一个新地址，用 API 断言。
查看 →
/use-cases/client-operations
客户运营
把入站邮件送到该处理它的流程里。
查看 →
/features/email-verification
地址验证
在代理依赖某个地址之前先检查它。
查看 →
/docs
API 参考
邮箱地址、入站消息、出站和域名。
查看 →