全部产品

DoH JSON API

更新时间:2020-09-04 14:02:55

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

请求参数 :

参数

类型

描述

实例

使用方法和默认值

name

string

请求域名

name=www.taobao.com.

必选,无默认值

type

number

请求类型

type=1

可选,1

edns_client_subnet

IP

ECS IP

edns_client_subnet=1.2.3.4/24

DNS代理使用,普通客户端不适用

short

boolean

是否开启简洁模式

short=true or short=1

可选,默认关闭

uid

string

用户ID,即控制台上的AccountID

uid=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 为例)

A

1

IPv4地址

101.37.183.171

NS

2

NS记录

ns1.taobao.com.

CNAME

5

域名 CNAME 记录

www.taobao.com.danuoyi.tbcache.com.

SOA

6

ZONE 的 SOA 记录

ns4.taobao.com. hostmaster.alibabadns.com. 2018011109 3600 1200 3600 360

TXT

16

TXT 记录

"v=spf1 include:spf1.staff.mail.aliyun.com -all"

AAAA

28

IPv6 地址

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 。