邮箱有效性检测 API

检测邮箱地址是否有效:格式校验、域名 MX 解析、一次性临时邮箱与公共账号识别、常见域名拼写纠错;不连接邮件服务器

数据来源:公共 DNS(Cloudflare / 阿里)+ 内置名单

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data },支持跨域,免注册每天可免费调用 100 次,注册后每天 10000 次。

检测邮箱格式、域名能否收信、是否临时邮箱

GET /api/email/check

请求参数

  • email(必填):邮箱地址(域名部分支持中文域名),示例 zhangsan@gmial.com

返回字段

  • email(string):规范化后的邮箱(域名转为小写 ASCII);格式不正确时为原始输入(去掉首尾空白)
  • validFormat(boolean):格式是否正确
  • local(string):@ 前的用户名部分(保持原样,不改大小写)
  • domain(string):@ 后的域名部分(小写;中文域名已转为 punycode)
  • mxFound(boolean|null):域名能否收信:有 MX 记录,或没有 MX 但有公网 A / AAAA 记录时为 true;域名不存在、Null MX、都没有时为 false;DNS 查询失败或格式不正确时为 null
  • mxRecords(array):MX 记录,按优先级从高到低,最多 5 条
  • mxRecords[].exchange(string):邮件交换服务器域名
  • mxRecords[].priority(number):优先级,数字越小越优先
  • fallbackA(boolean):是否因为没有 MX 记录而退回到 A / AAAA 记录判断能收信
  • disposable(boolean):是否为一次性临时邮箱(内置几十个常见域名,含其子域名;名单不全)
  • freeProvider(boolean):是否为公共免费邮箱(QQ、163、Gmail、Outlook 等)
  • roleAccount(boolean):是否为 admin、support、noreply 这类公共角色账号
  • didYouMean(string|null):疑似拼写错误时给出的修正建议(如 zhangsan@gmail.com);没有时为 null
  • result(string):结论:deliverable 可投递 / risky 有风险(临时邮箱或角色账号)/ undeliverable 无法投递 / unknown 无法判断(DNS 查询失败)
  • reasons(array):结论的依据(中文说明)