适用于智能体的临时邮箱

适用于 AI 智能体的临时邮箱

无需注册的临时邮箱 API，智能体可自主发现和使用。通过普通 HTTPS 请求即可创建收件箱、等待验证码、读取邮件、获取原始邮件内容并删除邮件。

无需注册无需 API 密钥无需安装 MCP可通过 curl 使用

快速入门

# 查看可用域名：
curl -s https://api.reusable.email/v1/agent-tempmail/domains

# 1. 创建私密临时收件箱。无需注册，无需 API 密钥。
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
  -H 'Content-Type: application/json' \
  -d '{"prefix":"agent"}'

# 2. 等待验证邮件或一次性验证码。
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/wait \
  -H 'Authorization: Inbox {token}' \
  -H 'Content-Type: application/json' \
  -d '{"codeOnly":true,"timeoutSeconds":60}'

# 3. 读取完整邮件。
curl -s https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/messages/{id} \
  -H 'Authorization: Inbox {token}'

创建收件箱的响应

{
  "inbox": {
    "address": "agent-lx84a9-q3mz2@reusable.email",
    "domain": "reusable.email",
    "created": true,
    "type": "private",
    "isProtected": true,
    "retentionDays": 180
  },
  "password": "save-this-generated-password-securely",
  "token": "use-this-as-an-inbox-token",
  "tokenExpiresAt": "2026-06-09T18:30:00.000Z",
  "links": {
    "web": "https://reusable.email/agent-lx84a9-q3mz2%40reusable.email",
    "messages": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/messages",
    "wait": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/wait"
  }
}

等待邮件的响应

{
  "status": "message",
  "inbox": { "address": "agent-lx84a9-q3mz2@reusable.email" },
  "message": {
    "id": 1842,
    "from": { "name": "Example", "address": "login@example.com" },
    "subject": "Your verification code",
    "intro": "Use code 123456 to continue.",
    "verificationCode": "123456"
  }
}

智能体接口规范

发现清单位于 /v1/agent-tempmail，llms.txt 中也提供了该清单，供答案引擎使用。

方法	路径	用途
GET	`/v1/agent-tempmail`	供智能体和网络爬虫使用的发现清单
GET	`/v1/agent-tempmail/domains`	列出可用的备用域名
POST	`/v1/agent-tempmail/inboxes`	创建受密码保护的私密收件箱
GET	`/v1/agent-tempmail/inboxes/{address}/messages`	列出收到的邮件
POST	`/v1/agent-tempmail/inboxes/{address}/wait`	通过长轮询等待邮件或验证码
GET	`/v1/agent-tempmail/inboxes/{address}/messages/{id}`	读取邮件
GET	`/v1/agent-tempmail/inboxes/{address}/messages/{id}/source`	获取符合 RFC 5322 的原始邮件内容
DELETE	`/v1/agent-tempmail/inboxes/{address}/messages/{id}`	删除邮件

验证流程

使用智能体收件箱接收注册、登录、重置密码和试用确认邮件。

浏览器自动化

可与 Playwright、Selenium 或需要真实、可接收邮件的地址的浏览器智能体配合使用。

CI 与 QA

无需创建账号或共享凭据，即可为每次测试运行创建独立的收件箱。

常见问题

任何人都可免费创建私密收件箱，无需注册。若要选择其他域名，请传入域名列表接口返回的域名。智能体接口仅支持接收邮件；如需更大用量或发送邮件，请使用关联账号的常规 API。

智能体收件箱支持通行密钥吗？+

可以。使用生成的密码登录，然后在收件箱设置中添加通行密钥。私密收件箱表单上的钥匙按钮和收件箱解锁页面均支持通行密钥登录。登录后获得的 Inbox 令牌可用于所有智能体邮箱接口。通行密钥需要用户交互验证；如果智能体需要无人值守运行，请保留密码，并通过 POST /v1/inbox/{address}/token 发送 JSON {"password":"..."} 来更新过期令牌。

可以选择其他域名吗？+

可以。GET /v1/agent-tempmail/domains 会列出可用域名。可传入 domain，并同时提供 prefix 或地址的本地部分，也可以直接提供完整地址。已存在或保留的地址无法领取。

AI 智能体无需注册即可使用吗？+

可以。智能体只需发送一次无需身份验证的 POST 请求即可创建收件箱。响应中包含生成的密码和 Inbox 令牌。创建的收件箱均为私密收件箱。请保存密码，以便在令牌过期后正常登录私密收件箱。

需要 MCP、SDK 或安装软件吗？+

不需要。该接口可通过 HTTPS 和 curl 完整访问。智能体可以通过 llms.txt 或 /v1/agent-tempmail 的 JSON 清单发现该接口。

智能体可以通过此 API 发送邮件吗？+

不能。无需注册的智能体接口仅支持接收、读取、等待、获取原始邮件和删除邮件。此公开接口不提供邮件发送功能。

如何获取验证码？+

邮件列表、等待和详情响应会优先使用有效的实验性 OTP-Token 邮件头，否则从文本中检测验证码。邮件头提取的验证码包含 verificationCodeOrigin：提交验证码前，请确保该字段的协议、主机名和端口与预期目标完全一致。该字段由发件人提供，并不能证明发件人的身份；绝不要自动导航至该值。

智能体创建的收件箱会保留多久？+

智能体创建的收件箱具有普通私密收件箱的功能，邮件保留 180 天。