DoH JSON API

接口地址

• https://223.5.5.5/resolve?name=域名&type=记录类型&uid=AccountID&ak=AccessKey ID&key=****&ts=时间戳

• http://223.5.5.5/resolve?name=域名&type=记录类型&uid=AccountID&ak=AccessKey ID&key=****&ts=时间戳

• https://223.6.6.6/resolve?name=域名&type=记录类型&uid=AccountID&ak=AccessKey ID&key=****&ts=时间戳

• http://223.6.6.6/resolve?name=域名&type=记录类型&uid=AccountID&ak=AccessKey ID&key=****&ts=时间戳

请求参数

请求方式GET，请求参数请查看如下列表：

关于edns_client_subnet参数

edns_client_subnet是为了支持DNS ECS功能（RFC7871），将用户的子网信息传递给权威DNS，以便进行更精确的DNS解析和流量调度。其中，掩码越长的地址信息越精确，掩码越短则用户隐私效果越好，建议使用“/24”掩码长度。

关于type参数支持类型

鉴权相关参数key的生成算法

key = sha256(AccountID+AccessKey Secret+ts+qname+AccessKey ID)

注：加号（+）表示字符串相连，并非实际使用“+”。 

其中，Account ID 为数字直接转换的字符串，比如 9**9 用户，使用字符串为 "9**9"，ts为当前请求的时间戳，qname 为用户此次请求的域名，AccessKey ID 和 AccessKey Secret 参考创建密钥生成。

key 生成示例

请求示例

返回示例

{
    "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.XX.XX"
        },
        {
            "name":"www.taobao.com.danuoyi.tbcache.com.",
            "TTL":45,
            "type":1,
            "data":"47.246.XX.XX"
        }
    ]
    //"Authority" 权威段, 如果有数据与Answer字段一致 
    //"Additional" 附加段, 如果有数据与Answer字段一致
    // 可选 "edns_client_subnet":"1.2.XX.XX/24"  
}

返回值说明

short 模式应答示例：

以www.taobao.com为例，当请求为 A 记录时，请求 URL 为：

https://223.5.5.5/resolve?name=域名&type=A&uid=AccountID&short=1&ak=AccessKey ID&key=****&ts=时间戳

应答如下：

["221.229.XX.XX","61.155.XX.XX","221.229.XX.XX"]

当请求为 CNAME 记录时，URL 为：

https://223.5.5.5/resolve?name=域名&type=CNAME&uid=AccountID&short=1&ak=AccessKey ID&key=****&ts=时间戳

应答如下：

["www.taobao.com.danuoyi.tbcache.com."]

失败应答

请求失败时，HTTP响应的状态码为4xx/5xx，同时返回具体的错误码，用于调试或者障碍上报，结果用JSON 表示。

失败应答实例：

{
 "code":"UrlParameterError"
}

错误码列表