加载接口文档…
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=AAAA&host=google.com
接口信息备注
查询 IPv6 地址（type=AAAA / 28）。示例为 google.com。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| host | string | 必填 · 域名（自动剥离协议/路径/端口）；也兼容 domain · 示例：google.com |
| type | string | 可选 · 记录类型，此处固定 AAAA（也可用数字编码） · 默认 AAAA · 示例：AAAA |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| 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": "google.com",
"input": "google.com",
"type": "AAAA",
"type_code": 28,
"records": [
{
"type": "AAAA",
"type_code": 28,
"name": "google.com",
"ttl": 227,
"data": "2607:f8b0:400e:c0a::64",
"parsed": {
"ip": "2607:f8b0:400e:c0a::64"
},
"sources": [
"alidns"
]
},
{
"type": "AAAA",
"type_code": 28,
"name": "google.com",
"ttl": 227,
"data": "2607:f8b0:400e:c0a::65",
"parsed": {
"ip": "2607:f8b0:400e:c0a::65"
},
"sources": [
"alidns"
]
},
{
"type": "AAAA",
"type_code": 28,
"name": "google.com",
"ttl": 227,
"data": "2607:f8b0:400e:c0a::71",
"parsed": {
"ip": "2607:f8b0:400e:c0a::71"
},
"sources": [
"alidns"
]
},
{
"type": "AAAA",
"type_code": 28,
"name": "google.com",
"ttl": 227,
"data": "2607:f8b0:400e:c0a::8b",
"parsed": {
"ip": "2607:f8b0:400e:c0a::8b"
},
"sources": [
"alidns"
]
},
{
"type": "AAAA",
"type_code": 28,
"name": "google.com",
"ttl": 84,
"data": "2a00:1450:4010:c0f::64",
"parsed": {
"ip": "2a00:1450:4010:c0f::64"
},
"sources": [
"dnspod"
]
},
{
"type": "AAAA",
"type_code": 28,
"name": "google.com",
"ttl": 84,
"data": "2a00:1450:4010:c0f::65",
"parsed": {
"ip": "2a00:1450:4010:c0f::65"
},
"sources": [
"dnspod"
]
}
],
"total": 8,
"exec_ms": 138,
"sources": [
"alidns",
"dnspod",
"china360"
],
"notes": null
},
"tips": "极数本源 · https://apizero.cn"
}