加载接口文档…
0
累计调用
—
平均响应
—
服务可用性
500 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 300 次 · QPS 2
登录免费
当前方案每日 500 次 · QPS 5
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
https://apizero.cn/aidocs/dns-lookup/raw.md接口请求地址
https://v1.apizero.cn/api/dns-lookup
接口请求方式
POST
请求参数格式
APPLICATION/JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/dns-lookup
接口信息备注
需要 API Key。登录用户每日 50 次免费；匿名每日 30 次。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| domain | string | 必填 · 要查询的域名（别名 name/host） · 示例：example.com |
| type | string | 可选 · 记录类型，逗号分隔；ALL=A,AAAA,MX,TXT,CNAME · 示例：A |
| server | string | 可选 · 指定DNS服务器（逗号分隔） · 示例：8.8.8.8,1.1.1.1 |
| timeout | int | 可选 · 单请求超时秒（1~30） · 示例：5 |
| doh | int | 可选 · 1=强制走DoH（HTTPS） · 示例：0 |
| doh_provider | string | 可选 · DoH服务商：cloudflare/google/alibaba · 示例：cloudflare |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| domain | string | 查询的域名 |
| type | string | 查询的记录类型 |
| server | string | 响应的DNS服务器 |
| transport | string | 传输方式（udp/tcp/doh） |
| rcode | int | DNS响应码 |
| rcode_text | string | 响应码文本（NOERROR/NXDOMAIN等） |
| elapsed_ms | int | 查询耗时（毫秒） |
| answers | array | 应答记录数组（type/name/ttl/value） |
| truncated | bool | 是否被截断 |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"domain": "example.com",
"type": "A",
"server": "114.114.114.114",
"transport": "udp",
"rcode": 0,
"rcode_text": "NOERROR",
"elapsed_ms": 32,
"answers": [
{
"type": "A",
"name": "example.com",
"ttl": 300,
"value": "93.184.216.34"
}
],
"truncated": false
},
"request_id": "req_abc123",
"tips": "极数本源 · https://apizero.cn"
}