全部产品
云市场
云游戏

DoH JSON API

更新时间:2020-07-23 17:06:06

DoH JSON API的URL 接口 (提供TLS和非TLS API)

https://dns.alidns.com/resolve?

https://alidns_ip/resolve?

http://dns.alidns.com/resolve?

http://alidns_ip/resolve?

注意

其中alidns_ip是dns.alidns.com 的A记录,可以是以下两个地址之一 :223.5.5.5,223.6.6.6。

请求方式: GET

请求参数 :

参数类型描述实例使用方法和默认值
namestring请求域名name=www.taobao.com.必选,无默认值
typenumber请求类型type=1可选,1
edns_client_subnetIPECS IPedns_client_subnet=1.2.3.4/24DNS代理使用,普通客户端不适用
shortboolean是否开启简洁模式short=true or short=1可选,默认关闭
uidstring用户ID,即控制台上的AccountIDuid=6666可选

关于edns_client_subnet参数

edns_client_subnet是为了支持DNS ECS功能(RFC7871),将用户的子网信息传递给权威DNS,做更精确的DNS解析和流量调度。其中掩码越长地址信息越精确,掩码越短用户隐私效果越好。建议使用"/24" 掩码长度

注:该参数是特地为DNS代理(proxy)使用DoH JSON API场景设计,即用户发送DNS查询给DNS代理,DNS代理通过该参数携带用户的子网信息传递给阿里公共DNS,最后传递到权威DNS服务器。

例如edns_client_subnet=1.2.3.4/24,权威服务器会收到基于1.2.3.0/24地址前缀信息来帮助用户选择DNS链路

关于type参数支持类型:

记录类型ID意义示例(以 taobao.com , www.taobao.com 为例)
A1IPv4地址101.37.183.171
NS2NS记录ns1.taobao.com.
CNAME5域名 CNAME 记录www.taobao.com.danuoyi.tbcache.com.
SOA6ZONE 的 SOA 记录ns4.taobao.com. hostmaster.alibabadns.com. 2018011109 3600 1200 3600 360
TXT16TXT 记录"v=spf1 include:spf1.staff.mail.aliyun.com -all"
AAAA28IPv6 地址240e:e1:f300:1:3::3fa

请求示例:

http://dns.alidns.com/resolve?name=www.taobao.com.&type=1

返回示例:

{ "Status": 0, "TC": false, "RD": true, "RA": true, "AD": false, "CD": false, "Question": { // 请求段 "name": "www.taobao.com.", "type": 1 }, "Answer": [ // 应答段 { "name": "www.taobao.com.", "TTL": 45, "type": 5, "data": "www.taobao.com.danuoyi.tbcache.com." }, { "name": "www.taobao.com.danuoyi.tbcache.com.", "TTL": 45, "type": 1, "data": "47.246.24.234" }, { "name": "www.taobao.com.danuoyi.tbcache.com.", "TTL": 45, "type": 1, "data": "47.246.24.233" } ] //"Authority" 为权威段, 如果有数据,需要与Answer字段一致 //"Additional" 为附加段, 如果有数据,需要与Answer字段一致 // 可配置"edns_client_subnet":"1.2.3.4/24" }

注:用户可以在客户端应用或手机应用中调用DoH和DoH JSON API解析DNS 。