邮箱域名有效性检测

检测单个邮箱地址的格式、域名 MX/A/AAAA 收信基础条件，并识别部分常见邮箱服务商和常见临时邮箱域名。不会通过 SMTP VRFY/RCPT 探测邮箱账户是否真实存在，因此不能把结果当作“邮箱本人已验证”。

接口地址

请求方式POST / JSON

身份认证Bearer API Key

所属分类数据查询

调用费用免费

包月要求不强制包月

调用限制30 次/分钟

补充说明

POST JSON /api/v1/endpoints/email-domain-check，Bearer API Key。参数仅 email；检查格式、MX及A/AAAA兜底收信条件，不执行SMTP VRFY/RCPT邮箱存在性探测。详细字段和限制参见前台接口文档及 docs/API.md。

请求参数

除 Bearer API Key 请求头外，使用 application/json 发送以下字段。图片接口的文件需先转成纯 Base64 字符串提交。

字段名称	格式	说明
`email`	字符串	必填，单个标准邮箱地址，最多191字符；不支持批量

非预期参数将被忽略；非法参数 HTTP 422。接口执行异常统一返回失败响应，不计为成功扣点。请仅提交您有权处理的文本、图片或网页内容。

示例代码

将密钥和业务字段替换为自己的实际值，不要在公开网页或 App 内写入管理员密钥。

cURL

curl -X POST "https://api.dcykjgw.com/api/v1/endpoints/email-domain-check" \
  -H "Authorization: Bearer dcy_你的完整密钥" \
  -H "Content-Type: application/json" \
  -d '{"email":"support@qq.com"}'

JavaScript

fetch('https://api.dcykjgw.com/api/v1/endpoints/email-domain-check', {
  method: 'POST',
  headers: {'Content-Type':'application/json','Authorization':'Bearer dcy_你的完整密钥'},
  body: JSON.stringify({"email":"support@qq.com"})
}).then(r => r.json()).then(console.log);

响应结构

{
  "code": 0,
  "msg": "处理成功",
  "platform": "email-domain-check",
  "data": {
    "email": "support@qq.com",
    "format_valid": true,
    "domain": "qq.com",
    "is_disposable_domain": false,
    "provider": {"name":"腾讯QQ邮箱","detected_by":"domain"},
    "summary": {"status":"ready","mail_dns_ready":true,"delivery_route":"mx","has_mx":true,"mailbox_exists":null},
    "dns": {"mx":{"available":true,"records":[],"count":2},"a":{"available":true,"records":[],"count":1},"aaaa":{"available":true,"records":[],"count":0}},
    "mailbox_check": {"performed":false,"exists":null}
  }
}

summary.status 为 ready / not-configured / unknown。有 MX 时优先按 MX 判断；没有 MX 但存在 A/AAAA 时按邮件标准的地址记录兜底标记基础收信条件。mailbox_exists 固定为 null，因为本接口不会使用 SMTP VRFY/RCPT 探测具体邮箱账户，避免把反垃圾、灰名单或拒绝探测误判为“邮箱不存在”。临时邮箱识别仅使用本地常见域名列表，并非完整临时邮箱数据库。

返回参数说明

字段	格式	说明
`code`	数字	业务状态码，0 表示本次接口调用成功；非 0 时结合 msg 和 HTTP 状态码排查。
`msg`	字符串	本次请求结果说明，成功时描述处理结果，失败时给出可读错误原因。
`platform`	字符串	当前接口/平台标识，成功响应中用于区分具体接口来源。
`data`	对象	接口业务数据；具体字段含义见下方本接口字段说明。
`data.email`	字符串	规范化后的邮箱地址。
`data.format_valid`	布尔值	邮箱格式是否合法。
`data.domain`	字符串	邮箱域名。
`data.is_disposable_domain`	布尔值	是否命中本地常见临时邮箱域名列表。
`data.provider`	对象	识别出的邮箱服务商及识别方式。
`data.summary`	对象	邮箱域名收信能力摘要。
`data.dns`	对象	MX/A/AAAA DNS 查询结果。
`data.mailbox_check`	对象	具体邮箱账户存在性探测状态；当前不执行 SMTP 探测。

无效参数 HTTP 422；无效密钥 401；权限限制 403；点数不足 402；频率超限 429；服务暂不可用 503。

在线测试 · 邮箱域名有效性检测

请填写自己的 API Key。图片只上传到当前 API 请求，不保存到浏览器本地存储；图片 Base64 在下方结果中自动隐藏。

响应结果

填写参数后点击“发送测试请求”。