Email Syntax and Disposable Domain Check
收藏官方服务：
资源简介：
Check email syntax, disposable-domain status and DNS mail records with a daily refreshed domain list.
创建时间：
2026-09-06
原始信息汇总
Email Syntax and Disposable Domain Check 数据集详情总结
数据集概述
该数据集由 API 提供，用于检查电子邮件地址的语法有效性、一次性域名（Disposable Domain）归属以及 DNS 邮件配置。每次请求返回包含语法、一次性域名、DNS 和操作状态等信息的 JSON 响应，并在无法完成检查时明确标识未知状态。API 由用户 weirdly0 创建，隶属 Email 类别，目前仅有 1 名订阅者。
核心功能
- Email 语法验证与 IDNA 域名标准化：检查邮箱格式是否合法，并对国际化域名进行规范化处理。
- 一次性域名检测：基于每日定时刷新的域名列表，判断邮箱域名是否为一次性域名。
- DNS 邮件配置检查：分别报告 MX 记录、null-MX、隐式 MX 及 DNS 失败状态。
- 状态区分：提供快照新鲜度和操作状态，帮助用户区分“未发现异常”与“检查不可用”的情况。
接口信息
唯一端点
| 方法 | 路径 | 用途 |
|---|---|---|
| POST | /v1/check |
评估邮箱语法、一次性域名归属及 DNS 邮件配置，返回语法、一次性、DNS、操作状态及邮箱验证结果等字段；不检测邮箱是否存在 |
使用说明
- 请求体需包含
email字段（字符串类型，必填，长度 1-320 字符）。 - 请求体格式为
application/json，大小限制为 4 KiB。 - 输入仅支持最多 320 字符，不支持 SMTPUTF8 本地部分、显示名称、IP 字面量和本地专用域名。
- 无效语法返回 HTTP 200 且
syntax.valid=false、dns.status=not_checked；无效请求结构返回 422。 - 需要邮箱所有权证明时，应使用邮箱确认流程。
主要数据模型
CheckRequest
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
| string | 是 | 最少 1 字符，最多 320 字符；未知字段会被拒绝 |
CheckResponse
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| syntax | SyntaxResult | 是 | — | 语法检查结果 |
| disposable | DisposableResult | 是 | — | 一次性域名检测结果 |
| dns | DNSResult | 是 | — | DNS 邮件配置结果 |
| operational_status | string | 是 | — | 操作状态 |
| mailbox_verified | boolean | 否 | false | 邮箱是否验证通过 |
SyntaxResult
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| valid | boolean | 是 | 语法是否有效 |
| normalized | string/null | 否 | 规范化后的邮箱地址 |
| ascii_domain | string/null | 否 | ASCII 格式的域名 |
DisposableResult
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| disposable | boolean/null | 否 | — | 是否为一次性域名 |
| snapshot_timestamp | string/null | 否 | — | 域名列表快照时间戳 |
| stale | boolean | 否 | true | 快照是否过期 |
DNSResult
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| status | string | 是 | — | DNS 状态 |
| mx | array of string | 否 | [] | MX 记录列表 |
| accepts_mail | boolean/null | 否 | — | DNS 配置是否接受邮件 |
定价方案
| 套餐 | 价格 |
|---|---|
| BASIC | $0.00 / 月 |
| PRO | $35.00 / 月 |
服务指标
- 流行度：8.4
- 服务级别：100%
- 延迟：4522ms
- 测试通过率：100%
限制与注意事项
- 该 API 仅进行语法与域名筛查，不验证邮箱是否存在、不运行 SMTP 探测、不检测 catch-all 收件箱、不保证投递成功。
- 一次性域名列表可能存在遗漏或误报；每日刷新为定时任务，需关注快照新鲜度字段而非假定刷新成功。
- 重试机制建议使用带抖动指数的退避策略处理 429/503/504 等临时错误，并遵循
Retry-After头；超量配额需要重置或升级套餐，而非快速重试。
错误处理
- HTTP 状态码涵盖 200、400、401、413、415、422、429、500、503。
- 原始错误信息包含
error.code和error.request_id；RapidAPI 生成的错误可能采用不同格式。 - 无效输入（400/413/415/422）应在重试前修正；认证/订阅错误需检查密钥、主机和活跃计划。
