域名综合检测

一次检测公开域名的 DNS、SSL 证书与网站可访问状态。优先检测 HTTPS，失败时回退 HTTP；单项异常会作为检测结果返回，不会把目标站点异常误报成接口本身失败。

接口地址

请求方式POST / JSON

身份认证Bearer API Key

所属分类网站与域名

调用费用免费

包月要求不强制包月

调用限制15 次/分钟

补充说明

POST JSON /api/v1/endpoints/domain-check，Bearer API Key。参数仅 domain；只检测公开域名，网站状态优先HTTPS并在失败时安全回退HTTP，详细安全边界参见前台接口文档及 docs/API.md。

请求参数

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

字段名称	格式	说明
`domain`	字符串	仅域名，不包含 http(s)://、端口、路径或IP

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

示例代码

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

cURL

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

JavaScript

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

响应结构

{
  "code": 0,
  "msg": "处理成功",
  "platform": "domain-check",
  "data": {
    "domain": "api.dcykjgw.com",
    "checked_at": "2026-10-15T06:33:00Z",
    "summary": {"status":"healthy","dns_ok":true,"ssl_ok":true,"website_reachable":true},
    "dns": {"ok":true,"resolvable":true,"total_records":6,"ips":["203.0.113.10"],"counts":{"A":1,"AAAA":0,"CNAME":0,"MX":1,"NS":2,"TXT":2}},
    "ssl": {"checked":true,"available":true,"tls_valid":true,"expires_at":"2026-12-31T23:59:59Z","days_remaining":77,"issuer":"示例签发机构","status":"valid"},
    "website": {"checked":true,"available":true,"scheme":"https","http_status":200,"elapsed_ms":168,"redirect_count":0,"reachable":true}
  }
}

示例 IP、证书时间与签发机构仅用于展示字段结构。summary.status 为 healthy / partial / unreachable；DNS、SSL、网站状态分别独立返回，目标站点某一项异常不会把整个检测请求误判为接口故障。HTTPS无法完成时会安全回退HTTP；只允许公开域名及默认80/443端口，内网、环回、元数据地址和任意端口均拒绝访问。

返回参数说明

字段	格式	说明
`code`	数字	业务状态码，0 表示本次接口调用成功；非 0 时结合 msg 和 HTTP 状态码排查。
`msg`	字符串	本次请求结果说明，成功时描述处理结果，失败时给出可读错误原因。
`platform`	字符串	当前接口/平台标识，成功响应中用于区分具体接口来源。
`data`	对象	接口业务数据；具体字段含义见下方本接口字段说明。
`data.domain`	字符串	规范化后的被检测域名。
`data.checked_at`	字符串	检测时间。
`data.summary`	对象	DNS、SSL、网站可访问性的综合状态。
`data.dns`	对象	DNS 解析状态、IP、记录数量和错误信息。
`data.ssl`	对象	证书有效性、到期时间和 TLS 信息。
`data.website`	对象	HTTP/HTTPS 可访问状态、响应码、耗时及重定向信息。

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

在线测试 · 域名综合检测

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

响应结果

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