Temp Email

Create disposable temporary email inboxes and read incoming mail (OTP, confirmations, verification links) on demand. Keyless. Billed per request.

原始信息汇总

Temp Email API 数据总览

创建一次性/临时电子邮件收件箱，并按需读取收到的邮件（OTP码、注册确认、验证链接等）。无需密钥后端、无需设置、无需SMTP，适用于QA自动化、注册测试、爬虫流程和机器人验证。

• 基础URL：https://temp-email22.p.rapidapi.com
• 认证方式：通过请求头 X-RapidAPI-Key（您的RapidAPI密钥）和 X-RapidAPI-Host（temp-email22.p.rapidapi.com）进行认证。免费BASIC套餐即可激活密钥。
• 计费方式：按请求计费。
• 提供方：由Apivault构建和维护。

---

核心功能

• 创建收件箱：一次性调用创建临时收件箱，返回地址、密码和令牌。
• 轮询邮件：轮询收件箱以获取新消息，适合捕获一次性验证码。
• 读取邮件：获取完整的邮件正文（纯文本、HTML和附件）。
• 列出域名：获取可用域名列表，用于选择或随机生成地址。
• 删除收件箱：使用完成后删除收件箱。

---

接口端点

方法	路径	说明
GET	/api/temp-email/domains	列出可用收件箱域名
POST	/api/temp-email/create	创建一次性收件箱（返回地址+令牌）
POST	/api/temp-email/messages	列出收件箱中的消息
POST	/api/temp-email/message	读取单条消息（完整内容）
POST	/api/temp-email/delete	删除收件箱

关键流程：创建收件箱后获取一个 token，将该token传递给 /messages 和 /message 接口以读取该收件箱；也可使用 address + password 进行重新认证。

---

响应示例（关键字段）

创建收件箱（200） json { "success": true, "data": { "id": "6a2f0f8e...", "address": "[e-mail]", "password": "Xk29...", "token": "eyJ0eXAiOiJKV1Q..." } }

消息列表（200） json { "success": true, "data": { "count": 1, "messages": [ { "id": "abc123", "from": { "address": "[e-mail]", "name": "Service" }, "subject": "Your verification code", "intro": "Your code is 123456", "seen": false, "hasAttachments": false, "createdAt": "2026-06-14T20:00:00+00:00" } ] } }

读取单条消息（200）：返回包含 text、html（数组）、from、to、subject、attachments、createdAt 的完整消息。

---

错误码

状态码	含义
401	无效或过期的收件箱令牌
404	消息未找到
409	地址已被占用或无效（创建时）
502	邮件后端暂时不可用

错误响应格式：{ "success": false, "error": "invalid or expired inbox token" }

---

适用场景

• QA与测试自动化：验证注册/邮件流程，无需真实邮箱。
• OTP/2FA捕获：程序化读取一次性验证码。
• 爬虫与机器人流程：通过邮件验证关卡。
• 隐私保护：使用一次性地址，避免真实收件箱被暴露。