加载接口文档…
96
累计调用
158ms
平均响应
100.00%
服务可用性
500 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 100 次 · QPS 3
登录免费
当前方案每日 500 次 · QPS 10
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
https://apizero.cn/aidocs/dns-query/raw.md接口请求地址
https://v1.apizero.cn/api/dns-query
接口请求方式
GET
请求参数格式
URL QUERY
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/dns-query?type=A&host=baidu.com
接口信息备注
查询 IPv4 地址（type=A，默认）。文档示例为 baidu.com 真实 DoH 合并结果。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| host | string | 必填 · 域名（自动剥离协议/路径/端口）；也兼容 domain · 示例：baidu.com |
| type | string | 可选 · 记录类型，此处固定 A（也可用数字编码） · 默认 A · 示例：A |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| host | string | 规范化后的域名 |
| type | string | 请求类型（大写） |
| type_code | integer | 类型数字编码 |
| records | array | 记录列表：type / name / ttl / data / parsed / sources |
| total | integer | 记录总数 |
| exec_ms | integer | 耗时毫秒 |
| sources | array | 成功响应的 DoH 源 |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"host": "baidu.com",
"input": "baidu.com",
"type": "A",
"type_code": 1,
"records": [
{
"type": "A",
"type_code": 1,
"name": "baidu.com",
"ttl": 424,
"data": "110.242.74.102",
"parsed": {
"ip": "110.242.74.102"
},
"sources": [
"alidns",
"china360",
"dnspod"
]
},
{
"type": "A",
"type_code": 1,
"name": "baidu.com",
"ttl": 424,
"data": "111.63.65.103",
"parsed": {
"ip": "111.63.65.103"
},
"sources": [
"alidns",
"china360",
"dnspod"
]
},
{
"type": "A",
"type_code": 1,
"name": "baidu.com",
"ttl": 424,
"data": "111.63.65.247",
"parsed": {
"ip": "111.63.65.247"
},
"sources": [
"alidns",
"china360",
"dnspod"
]
},
{
"type": "A",
"type_code": 1,
"name": "baidu.com",
"ttl": 424,
"data": "124.237.177.164",
"parsed": {
"ip": "124.237.177.164"
},
"sources": [
"alidns",
"china360",
"dnspod"
]
}
],
"total": 4,
"exec_ms": 170,
"sources": [
"alidns",
"dnspod",
"china360"
],
"notes": null
},
"tips": "极数本源 · https://apizero.cn"
}