Gmailnator

API for Gmailnator Website

原始信息汇总

Gmailnator API 数据集概述

基本信息

• 数据集名称: Gmailnator
• API 版本: v2 (current)
• 基础 URL: https://gmailnator.p.rapidapi.com/api
• 数据源网站: https://www.emailnator.com
• 数据集描述: 该 API 为 Gmailnator 网站提供接口服务。Gmailnator 是网络上最先进的临时电子邮件服务，用于阻止垃圾邮件并保障安全。它允许用户使用真实的 Gmail 电子邮件地址。

认证方式

所有 API 请求都需要以下请求头：

请求头	是否必需	描述
Content-Type	是	必须为 application/json
x-rapidapi-host	是	必须为 gmailnator.p.rapidapi.com
x-rapidapi-key	是	您的 RapidAPI 密钥

端点概览

方法	端点	描述
POST	/emails/generate	生成单个临时电子邮件地址
POST	/emails/generate-bulk	批量生成多个临时电子邮件地址
POST	/inbox/	列出指定邮箱地址的邮件列表
GET	/inbox/{messageID}	获取单封邮件的完整内容
DELETE	/inbox/{messageID}	删除邮件
GET	/inbox/attachment/{encryptedData}/{attachmentId}	下载邮件附件

详细功能说明

1. 电子邮件生成

1.1 生成单个电子邮件

• 端点: POST /emails/generate
• 请求体参数:
  • type (string[], 可选): 电子邮件类型标识符数组。如果省略，则随机选择一种类型。
• 有效 type 值:
  • public_email_domain, public_gmail_plus, public_gmail_dot, public_googlemail
  • private_email_domain, private_gmail_plus, private_gmail_dot, private_googlemail
• 成功响应 (200 OK): 包含 status, email, type 字段的 JSON 对象。

1.2 批量生成电子邮件

• 端点: POST /emails/generate-bulk
• 请求体参数:
  • type (string[], 可选): 电子邮件类型标识符数组。如果省略，则随机选择类型。
  • count (integer, 可选，默认值: 100): 要生成的电子邮件数量。最小值: 1，最大值: 500。
• 成功响应 (200 OK): 包含 status 和 results 数组的 JSON 对象，数组内每个对象包含 email 和 type 字段。

2. 收件箱管理

2.1 列出收件箱邮件

• 端点: POST /inbox/
• 请求体参数:
  • email (string, 必需): 要获取邮件的邮箱地址。必须是有效的电子邮件格式。
  • limit (integer, 可选，默认值: 10): 要返回的最大邮件数量。最大值: 20。
• 成功响应 (200 OK): 包含 status, messages 数组和 message_count 的 JSON 对象。messages 数组中的每个对象包含 id, from, subject, timestamp, time_ago 字段。

2.2 获取单封邮件

• 端点: GET /inbox/{messageID}
• URL 参数:
  • messageID (string): 从收件箱列表端点返回的加密消息标识符。
• 成功响应 (200 OK): 包含邮件完整详情的 JSON 对象，如 id, from, subject, timestamp, time_ago, content, has_attachments。如果 has_attachments 为 true，则包含 attachments 数组，数组内对象包含 id, filename, mimeType, size 字段。

2.3 删除邮件

• 端点: DELETE /inbox/{messageID}
• URL 参数:
  • messageID (string): 从收件箱列表端点返回的加密消息标识符。
• 成功响应 (200 OK): 包含 success 和 message 字段的 JSON 对象。

2.4 下载附件

• 端点: GET /inbox/attachment/{encryptedData}/{attachmentId}
• URL 参数:
  • encryptedData (string): 从收件箱列表端点返回的加密消息标识符。
  • attachmentId (string): 从“获取单封邮件”响应的 attachments 数组中获取的附件 ID。
• 成功响应 (200 OK): 返回二进制文件流，并附带 Content-Type, Content-Length, Content-Disposition 等响应头。

3. 电子邮件类型参考

API 支持 8 种电子邮件类型，分为公共和私有两类：

类型标识符	类别	标签 ID	描述
public_email_domain	公共	1	自定义域名电子邮件。生成随机的 7 字符用户名@域名。（例如：[e-mail]）
public_gmail_plus	公共	2	Gmail 加号寻址。在用户名后追加 +random。（例如：[e-mail]）
public_gmail_dot	公共	3	Gmail 点号技巧。在用户名中插入随机点号。（例如：[e-mail]）
public_googlemail	公共	8*	Googlemail 点号技巧。与 gmail_dot 相同，但使用 @googlemail.com。（例如：[e-mail]）
private_email_domain	私有	4	与 public_email_domain 相同，但使用私有托管账户。
private_gmail_plus	私有	5	与 public_gmail_plus 相同，但使用私有托管的 Gmail 账户。
private_gmail_dot	私有	6	与 public_gmail_dot 相同，但使用私有托管的 Gmail 账户。
private_googlemail	私有	9*	与 public_googlemail 相同，但使用私有托管的 Gmail 账户。

4. 错误处理

标准错误响应格式

• 验证错误 (422 Unprocessable Entity): 包含 message 和 errors 对象的 JSON。
• 应用程序错误 (4xx / 5xx): 包含 error 或 status 与 message 字段的 JSON。

HTTP 状态码摘要

状态码	含义	发生情况
200	OK	请求成功。
400	Bad Request	加密消息 ID 格式错误或数据结构无效。
403	Forbidden	加密数据已被篡改（附件端点解密失败）。
404	Not Found	系统中未找到邮箱地址，或请求的邮件不存在。
422	Unprocessable Entity	请求验证失败（缺少必需字段、值无效）。
500	Internal Server Error	Gmail API 失败、令牌刷新失败或其他意外的服务器错误。

搜集汇总

背景与挑战

背景概述

该数据集提供Gmailnator网站的相关API接口服务。