请求
https://1.1.1.1/dns-query?ct=application/dns-json&name=example.com&type=A
返回结果JSON示例
{"Status": 0,"TC": false,"RD": true, "RA": true, "AD": true,"CD": false,"Question":[{"name": "example.com.", "type": 1}],"Answer":[{"name": "example.com.", "type": 1, "TTL": 9323, "data": "93.184.216.34"}]}
请求参数:
- name
字符串,必须包含的参数,所请求的记录。
长度必须在1到253之间(可忽略 example.com.
的尾点)
不支持非ASCII字符的名称,但不会明确返回拒绝。IDN国际化域名必须使用punycode格式(形如如“xn-”而不是“中文”)。
- type
字符串, 默认为: 1
,请求的记录类型
可以是字符串或对应的数值 (字符串不区分大小写,例如A
或aaaa
均可)
- cd
布尔值, 默认为: false
为true时,禁用DNSSEC验证。
- edns_client_subnet
字符串, 默认为空
自定义EDNS客户端IP地址,例如:1.2.3.4
, 1.2.3.4/24
, 2001:700:300::/48
为 0.0.0.0/0
或 0.0.0.0
时匿名查询,DoH服务器不会暴露您的IP地址。
返回参数:
- Status
DNS响应状态码。为0时表示OK。
-
1
:查询格式错误2
:服务器内部错误3
:不存在4
:错误码不支持5
:请求被拒绝6
:在不应当出现时出现7
:记录类型不存在8
:记录类型设置应当存在但是却不存在9
:服务器不具备改管理区的权限10
:记录不在管理区中
- TC
响应是否设置截断位,DoH均为 false
- RD
表示是否设置Recursive Desired,DoH均为 true
- RA
表示是否设置 Recursion Available,DoH均为 true
- AD
表示是否开启DNSSEC验证
- CD
表示客户端是否请求禁用DNSSEC验证
- Question
- name 请求的名称
- type 请求的DNS记录类型
- Answer
- name 返回记录名
- type 返回记录类型
- TTL 缓存过期时间(秒)
- data 给定名称和类型的DNS记录的值