验证
邮箱验证 API
通过全面的语法、域名和邮箱验证来校验邮箱地址。减少退信,提升送达率,并保护您的平台免受垃圾信息影响。
GET
邮箱验证 API
快速开始
发起请求时,只需提供您的唯一api_key 和要检查的 email——无需其他参数:
请求参数
响应参数
响应以紧凑、标准化的 JSON 格式返回。检测到可能的拼写错误时建议的修正(例如
johnsmith@gmial.com => johnsmith@gmail.com)。无建议时为空。
Cleariflow 对该地址能否接收邮件的评估。可能的值:
DELIVERABLE、UNDELIVERABLE、UNKNOWN。DELIVERABLE 需要 SMTP 验证成功;若存在
MX 记录但 SMTP 无法确认邮箱(大型服务商常见),结果为 UNKNOWN。所有计划执行相同的
验证;免费计划仅在月度配额和速率限制上有所不同(见错误代码 422、429)。若域名配置为
全收(catch-all)
则为 true。
当域名的 MX 记录 存在时为 true。
当
SMTP
验证成功时为 true。若 SMTP 失败但其他检查通过,结果可能为
UNKNOWN。我们建议不要仅因 SMTP 失败而阻止注册或表单提交。请求示例
示例:可能的拼写错误
此示例展示检测到提交地址中可能存在拼写错误的情况。 即使发现可能的拼写错误,所有其他检查(如免费邮箱、 一次性域名)仍针对原始提交的地址执行——而非建议的修正地址。示例:无效格式
此示例演示格式检查失败的地址。当is_valid_format 为 false 时,后续检查(如 is_free_email、
is_role_email)将被跳过并报告为 false。
批量上传(CSV)
不想直接调用 API?可使用 CSV 批量上传工具——处理完成后结果将通过邮件发送给您。 上传 CSV 时请遵循以下准则:- 将邮箱地址放在第一列。
- 删除所有空白行。
- 每行一个地址。
- 文件最多 50,000 行。