GateMail API
收藏GateMail API 数据集概述
基本信息
- API名称: GateMail API
- 功能描述: 实时电子邮件验证，专为现代Web和无服务器应用程序设计。
- 主要特性:
- 验证电子邮件地址在技术上是否有效。
- 执行多项检查：语法验证（符合RFC标准格式）、域名存在性检查、使用可靠的DNS解析器（dnspython）进行MX DNS记录验证。
- 针对网关和无服务器平台（Vercel, RapidAPI）进行了优化，确保正常工作。
- 优势:
- 快速响应。
- 完全兼容无服务器环境。
- 不发送电子邮件，不进行SMTP探测（安全且非侵入式）。
- 简单的REST接口。
- 支持扩展和货币化。
典型用例
- 用户注册表单验证。
- 防止虚假或拼写错误的电子邮件。
- 清理电子邮件列表。
- 降低退信率。
重要说明
- MX验证检查域名是否可以接收电子邮件，而不是检查邮箱是否存在。
- 某些有效域名可能故意阻止MX查询。
- 该API适用于需要轻量级、可靠的电子邮件验证，且不希望进行有风险的SMTP检查或依赖第三方的情况。
详细功能
- 验证电子邮件地址并评估其质量和风险。
- 检测一次性电子邮件。
- 修复常见的域名拼写错误。
- 对电子邮件域名进行分类（TEMP / B2C / B2B）。
- 检查域名是否具有有效的MX记录。
技术规格
- 基础URL:
https://gatemail-api1.p.rapidapi.com - 所有请求和响应均使用JSON格式。
认证
- 使用RapidAPI认证。
- 每个请求必须包含以下头部：
X-RapidAPI-Key: YOUR_RAPIDAPI_KEYX-RapidAPI-Host: gatemail-api1.p.rapidapi.com
- 使用内置测试控制台时，RapidAPI会自动注入这些头部。
端点
1. 验证电子邮件
-
端点:
POST /check-email -
描述: 验证电子邮件地址并评估其质量。
-
请求体（JSON）: json { "email": "user@example.com" }
-
请求参数:
字段 类型 必填 描述 email string 是 必须是有效的电子邮件格式 -
响应示例: json { "input": "user@gmial.com", "corrected": "user@gmail.com", "correction_applied": true, "temporary": false, "quality": "B2C", "mx_valid": true }
-
响应字段:
字段 类型 描述 input string 用户提供的原始电子邮件 corrected string 域名拼写错误纠正后的电子邮件 correction_applied boolean 如果域名被自动纠正，则为True temporary boolean 如果电子邮件来自一次性提供商，则为True quality string 域名类别：TEMP、B2C或B2B mx_valid boolean / null MX记录验证结果 -
域名质量值:
值 含义 TEMP 一次性/临时电子邮件提供商 B2C 消费者电子邮件提供商（Gmail、Outlook、Yahoo等） B2B 商业或自定义域名 -
MX验证行为:
值 含义 true 域名具有有效的MX记录 false 域名没有MX记录 null DNS查找失败或超时
2. 健康检查
-
端点:
GET /health -
描述: 返回API状态。
-
响应示例: json { "status": "ok" }
-
用途: 用于正常运行时间监控。
重要行为
- 一次性（TEMP）电子邮件会立即返回。
- 无拼写错误纠正。
- 无MX查找。
- MX查找会缓存1小时以降低延迟。
- 拼写错误纠正仅适用于已知的B2C域名。
常见用例
- 在用户注册期间阻止一次性电子邮件。
- 自动修复常见的电子邮件拼写错误。
- 过滤低质量或有风险的潜在客户。
- 在发送交易电子邮件之前验证域名。
错误
| 状态码 | 描述 |
|---|---|
| 401 | 缺少或无效的API密钥 |
| 422 | 无效的电子邮件格式 |
| 429 | 超过速率限制 |
| 500 | 内部服务器错误 |
验证错误（422）
当电子邮件字段缺失或不是有效的电子邮件地址时返回。
示例响应： json { "detail": [ { "loc": ["body", "email"], "msg": "value is not a valid email address", "type": "value_error.email" } ] }
示例代码（Python）
python import requests
url = "https://gatemail-api1.p.rapidapi.com/check-email"
headers = { "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY", "X-RapidAPI-Host": "gatemail-api1.p.rapidapi.com", "Content-Type": "application/json" }
payload = {"email": "example@gmial.com"}
response = requests.post(url, json=payload, headers=headers) print(response.json())
注意事项
- 请勿在前端代码中暴露您的API密钥。
- 在生产环境中使用环境变量。
- 该API针对速度和低延迟进行了优化。
