您需要可以按需生成的 Gmail 风格的临时地址,以便用于测试、注册流程或 QA 脚本,并且您需要在本周内完成。通过本文,您将能够生成一个临时 Gmail 地址,批量生成多达 500 个具有点/加号规则的唯一地址,并检查给定地址的收件箱活动——使用来自 Zyla API Hub 的一个 API 密钥。
此 API 的功能及使用时机
临时 Gmail API 提供了临时 Gmail 兼容地址的程序化生成以及检查最近收件箱活动以进行验证检查的方法。典型的使用案例包括:
- 每次运行都需要唯一的 Gmail 格式地址的端到端测试。
- 使用真实的、可交付风格的电子邮件填充演示环境。
- 创建并行注册流程,以测试点和加号地址的行为。
- 轮询最近的活动以进行分阶段的验证步骤。
该 API 在 Zyla API Hub 上运行,因此您使用一个 API 密钥、一致的授权头以及整个市场的订阅 + 配额模型。
在 Zyla API Hub 上入门
打开 Zyla 上的临时 Gmail API 页面,订阅并获取您的密钥。身份验证是标准的承载令牌。
- 前往市场列表: 开始 7 天的临时 Gmail API 试用。
- 点击订阅(或在可用时点击开始免费试用)以获取您的密钥。
- 发送请求时使用:Authorization: Bearer YOUR_API_KEY。
Zyla 使用订阅 + 配额(而不是按调用计费)。请查看 API 页面以获取当前访问选项和定价。您的密钥可在 Zyla API Hub 上的 10,000 多个公共 API 中使用。
您将使用的端点
以下所有端点都是 Zyla 的中心 URL 上的 HTTP GET,并且需要授权头。仅应发送文档中记录的参数。
1) 生成 Gmail
生成一个临时 Gmail 地址。
- 方法:GET
- URL:https://zylalabs.com/api/8382/temporary-gmail-api/14645/generate-gmail
- 所需参数:
- domain (string):random
cURL(复制粘贴即可):
curl -s -X GET "https://zylalabs.com/api/8382/temporary-gmail-api/14645/generate-gmail?domain=random" \
-H "Authorization: Bearer YOUR_API_KEY"
示例 JSON 响应:
{
"email": "[email protected]"
}
您实际使用的字段:
- email:生成的 Gmail 风格地址,您可以立即将其插入注册或测试流程中。
2) 批量 GMail
生成多达 500 个唯一的临时电子邮件,并可选择性地使用点/加号/域过滤器。
- 方法:GET
- URL:https://zylalabs.com/api/8382/temporary-gmail-api/14647/bulk-gmail
- 参数:
- dot (string, optional):true
- plus (string, required):false
cURL:
示例 JSON 响应:
注意:
- count:此批次返回的电子邮件数量。
- emails:唯一 Gmail/Googlemail 变体的数组。可能会应用点和加号地址,具体取决于您的参数。
3) 收件箱
检索指定地址的最近活动,包括查询时间、响应时间、找到的结果数量以及任何可用的验证消息。
- 方法:GET
- URL:https://zylalabs.com/api/8382/temporary-gmail-api/14648/inbox
- 参数:
- email (string, required):[email protected]
cURL:
示例 JSON 响应:
注意:
- email:此活动所属的地址。
- queried_at:检查收件箱时的时间戳字符串(API 未指定时区)。
- response_time:API 的处理时间的持续时间字符串。
- count:此结果中可用消息的数量。
- messages:消息数组;在此示例中为空。
快速入门:生成一次性 Gmail 并在测试中使用
最快的路径是调用生成 Gmail,将电子邮件存储在您的测试上下文中,然后运行您的流程。
Python 示例(请求)
此示例调用生成 Gmail 端点,提取电子邮件值,并将其打印以供后续步骤使用。
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/8382/temporary-gmail-api/14645/generate-gmail"
params = {"domain": "random"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
email = data.get("email")
print(f"生成的临时 Gmail: {email}")
# 示例:将其传递到您的注册负载或测试运行器
# signup(user_email=email)
预期的响应形状是上面的官方示例;检查 data["email"] 并将该地址插入到您的自动化中。
实际实施注意事项
- 身份验证:始终发送 Authorization: Bearer YOUR_API_KEY。
- 超时:设置客户端超时(例如,30 秒)以保持测试运行的可预测性。
- 幂等性:生成端点每次调用都会创建新的变体;如果需要可重复的运行,请保留所选地址。
- 点和加号语义:批量 GMail 端点允许通过其文档参数控制点和加号。使用 dot=true 获取带点的变体,并根据示例使用 plus=false 以避免加号地址。
- 收件箱时间戳:queried_at 作为字符串返回;API 未指定时区。按原样存储或使用您的系统时间进行注释以进行审计。
- 缓存和分页:这些端点未指定。如果您正在为收件箱构建轮询器,请实现回退并避免不必要的重复调用。
- 配额:Zyla 使用订阅 + 配额。监控您的调用量,并查看市场列表以获取限制和当前访问选项。
工作流程配方
1) 一次性注册测试
- 调用生成 Gmail,domain=random。
- 在您的注册表单中使用返回的电子邮件。
- 可选地轮询收件箱以验证消息是否可用,如果您的工作流程依赖于收据检查。
2) 使用多样地址进行负载测试注册
- 调用批量 GMail,dot=true&plus=false 以获取一批变体。
- 将地址分配到您的工作者中以避免冲突。
- 记录哪个地址映射到哪个测试用例以实现可重复性。
3) 在分阶段进行电子邮件验证 QA
- 每次运行提供一个唯一地址(生成 Gmail)。
- 触发您的系统发送验证消息。
- 调用该地址的收件箱并存储 queried_at、response_time 和您需要的任何消息以进行验证。
通过 MCP 从 AI 代理调用 API
如果您在 MCP 兼容客户端(例如,Claude Code、Cursor、Windsurf)中编排流程,您可以通过 MCP 网关调用 Zyla API。使用以下端点:
在配置 MCP 工具 URL 时,在查询字符串中提供您的密钥,格式为 apikey=YOUR_API_KEY(例如,https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY)。然后从您的代理调用临时 Gmail API 操作。确切的工具配置取决于您的客户端;请参考您的 MCP 客户端文档,并在工具转发调用时保持与上述相同的授权模型和参数。
故障排除提示
- 401 或 403:确认您发送了 Authorization: Bearer YOUR_API_KEY,并且该密钥在列表中处于活动状态。
- 空收件箱:消息缺失是有效的;请验证您的上游系统是否实际发送了电子邮件,并在得出失败结论之前考虑重试/回退。
- 批量 GMail 中的意外计数:API 返回最多 500;确切计数可能会有所不同。读取计数字段并相应地迭代电子邮件。
- 编码加号地址:在将电子邮件传递给收件箱端点时,按示例所示对 + 和 @ 等字符进行 URL 编码。
可复制的请求
生成一个 Gmail
批量 Gmail 变体(点开启,加号关闭)
检查特定地址的收件箱活动
常见问题
我需要什么身份验证头?
在每个请求中发送 Authorization: Bearer YOUR_API_KEY。
我一次可以获取多少电子邮件?
使用批量 GMail 端点生成多达 500 个唯一电子邮件,受限于您的订阅配额。
收件箱端点是否返回完整的消息内容?
收件箱端点返回最近活动字段和可用消息以进行验证。您将看到的确切字段在此未记录;如果存在,请处理消息数组。
是否支持点和加号地址?
批量 GMail 通过点和加号参数支持点和加号规则。使用 dot=true 和 plus=false,如示例所示以控制变体。
是否有免费计划?
Zyla 使用订阅 + 配额模型。请查看市场列表以获取当前访问选项和定价,包括可用的试用。
准备将其集成到您的管道中吗?创建您的 API 密钥并立即发送您的集成: 开始 7 天的临时 Gmail API 试用。在 Zyla API Hub 上探索更多数千个现成服务,所有服务均使用一个密钥。