receivemail.dev

receivemail.dev

通过一次 API 调用即可获取可接收真实邮件的一次性邮箱地址。无需注册、配置 SMTP 或创建账户。专为测试验证邮件/OTP 邮件、注册流程，以及 QA 测试套件原本需要使用真实收件箱的场景而打造。

在线地址：receivemail.dev。

工作原理

# create a mailbox (default: expires in 15 min)
curl -X POST https://receivemail.dev/mailboxes
# => {"address":"[email protected]","expiresAt":"...","secret":"..."}

# trigger your own app's email to that address, then poll:
curl https://receivemail.dev/mailboxes/[email protected]/messages \
  -H "Authorization: Bearer <secret from above>"
# => {"address":"...","messages":[{"from_address":"...","subject":"...","body_text":"..."}]}

创建时返回的 secret 是唯一凭证——请妥善保存，因为没有账户/登录功能。@receivemail.dev 下的任何地址都可以接收邮件，即使从未明确预留过也不例外（与任何一次性邮箱服务相同），但只有预留的地址才有用于读取邮件的 secret。

端点

端点	说明
POST /mailboxes	创建新地址。请求体可选 {"ttlMinutes": 1-60}，默认值为 15。公开接口，无需令牌。
GET /mailboxes/:address	元数据（创建时间/到期时间）。需要使用该邮箱自己的 secret 作为 Bearer 令牌。
GET /mailboxes/:address/messages	最近 50 封邮件，按时间从新到旧排列。使用相同的 secret。
GET /mailboxes/:address/wait?timeout=25&since=<ISO>	长轮询：有新邮件到达时立即返回一封比 since 更新的邮件；若等待 timeout 秒后仍无邮件，则返回 {"timed_out":true}（最长 25 秒）。使用相同的 secret。

限制

• 每个 IP 每分钟最多创建 20 个邮箱，全局每天最多创建 12,000 个。
• 邮箱最长有效期为 60 分钟——此服务适用于短期测试流程，不适用于永久收件箱。
• 邮箱到期 24 小时后，邮件将被清理。

免费使用，无需 API 密钥即可创建邮箱。

架构

完全采用无服务器架构，与其他任何服务均不共享基础设施：

• Cloudflare Email Routing 在 receivemail.dev 区域接收实际邮件。
• Cloudflare Worker（src/index.ts）——email() 处理程序解析并存储收到的邮件，使用 postal-mime；fetch() 处理程序提供 REST API 和着陆页（src/landing.ts）；scheduled() 处理程序每天清理过期邮箱、旧邮件和速率限制数据桶。
• D1（schema.sql、schema_v2.sql、schema_v3.sql）——包含 emails、mailboxes（每个邮箱都有用于通过能力式访问读取邮件的 secret）和 rate_limits。

本地开发

npm install
npx wrangler dev      # local dev server
npm run deploy        # wrangler deploy

需要拥有包含 receivemail.dev 区域的 Cloudflare 账户，配置好 Email Routing，并在 wrangler.toml 中将 D1 数据库绑定为 DB。

相关项目

sms-florin——同样的思路，但用于接收 SMS/OTP 验证码，而不是电子邮件（租用真实的英国电话号码）。