加载接口文档…
142
累计调用
115ms
平均响应
100.00%
服务可用性
2,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 50 次 · QPS 2
登录免费
当前方案每日 2,000 次 · QPS 5
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
https://apizero.cn/aidocs/dns-check/raw.md接口请求地址
https://v1.apizero.cn/api/dns-check
接口请求方式
GET
请求参数格式
QUERY STRING
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/dns-check?domain=domain
接口信息备注
匿名 QPS=2、日 50 次；登录后 QPS=5、日 200 次。一次请求会向 4 家 DoH 各发 2 条查询（A + AAAA），共 8 个并发 HTTPS 请求。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| domain | string | 必填 · 要检测的域名（如 baidu.com，自动剥离 http(s):// 协议头与路径，最长 253 字符） |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| domain | string | 规范化后的域名（去协议、去路径、转小写） |
| input | string | 原始输入回显 |
| exec_ms | integer | 总耗时（毫秒） |
| summary | object | ★ 综合判定（一眼看懂） |
| summary.status_text | string | 人类可读的状态描述 |
| summary.risk_level | string | 风险等级：safe / safe_with_geodns / suspicious / hijack_likely / unknown |
| summary.risk_score | integer | 安全评分 0~100（越高越安全；< 50 建议关注） |
| summary.explain | string | 判定依据说明 |
| summary.cname_chain | string[] | CNAME 链路（去重合并所有 DoH 返回的 CNAME） |
| summary.success_count | integer | 成功响应的 DoH 数量 |
| summary.total_count | integer | DoH 总数（固定 4） |
| summary.unique_ipv4_count | integer | 去重后的 IPv4 数量 |
| summary.unique_ipv6_count | integer | 去重后的 IPv6 数量 |
| unique_ipv4 | string[] | 所有 DoH 返回 IPv4 的并集（去重） |
| unique_ipv6 | string[] | 所有 DoH 返回 IPv6 的并集（去重） |
| servers | array | 4 家 DoH 各自的明细 |
| servers[].key | string | 服务器 key：alidns / dnspod / china360 / cloudflare |
| servers[].name | string | 展示名称 |
| servers[].status | string | 状态：ok / timeout / failed / parse_error |
| servers[].error | string | 失败原因（status≠ok 时存在） |
| servers[].latency_ms | integer | 该服务器查询耗时（毫秒，A+AAAA 两次的最大值） |
| servers[].ipv4 | string[] | 该服务器返回的 A 记录（去重） |
| servers[].ipv6 | string[] | 该服务器返回的 AAAA 记录（去重） |
| servers[].cname_chain | string[] | 该服务器返回的 CNAME 跳转链路（去重） |
| servers[].ttl_min | integer | 该服务器返回的最小 TTL（秒；可作 DNS 缓存参考） |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"domain": "taobao.com",
"input": "https://www.taobao.com/page",
"exec_ms": 312,
"summary": {
"status_text": "DNS 解析正常",
"risk_level": "safe",
"risk_score": 95,
"explain": "4 家 DoH 全部相互验证通过，未检测到劫持迹象。",
"cname_chain": [
"www.taobao.com.danuoyi.tbcache.com"
],
"success_count": 3,
"total_count": 4,
"unique_ipv4_count": 8,
"unique_ipv6_count": 0
},
"unique_ipv4": [
"59.82.121.163",
"59.82.122.130",
"59.82.122.140",
"59.82.122.165",
"59.82.43.234",
"59.82.43.238",
"59.82.43.239",
"59.82.44.240"
],
"unique_ipv6": [],
"servers": [
{
"key": "alidns",
"name": "AliDNS",
"status": "ok",
"error": null,
"latency_ms": 105,
"ipv4": [
"59.82.121.163",
"59.82.122.130",
"..."
],
"ipv6": [],
"cname_chain": [
"www.taobao.com.danuoyi.tbcache.com"
],
"ttl_min": 60
},
{
"key": "dnspod",
"name": "DNSPod",
"status": "ok",
"latency_ms": 180,
"ipv4": [
"59.82.121.163",
"..."
]
},
{
"key": "china360",
"name": "360",
"status": "ok",
"latency_ms": 117
},
{
"key": "cloudflare",
"name": "Cloudflare",
"status": "timeout",
"error": "Operation timed out after 6000 ms",
"latency_ms": 6000
}
]
},
"request_id": "mota...",
"tips": "极数本源 · https://apizero.cn"
}