Alibaba Cloud DNS：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"
}

錯誤碼列表