Alibaba Cloud DNS:DoH JSON API

エンドポイント

• https://223.5.5.5/resolve?name=domain&type=record type&uid=AccountID&ak=AccessKey ID&key=****&ts=timestamp

• http://223.5.5.5/resolve?name=domain&type=record type&uid=AccountID&ak=AccessKey ID&key=****&ts=timestamp

• https://223.6.6.6/resolve?name=domain&type=record type&uid=AccountID&ak=AccessKey ID&key=****&ts=timestamp

• http://223.6.6.6/resolve?name=domain&type=record type&uid=AccountID&ak=AccessKey ID&key=****&ts=timestamp

リクエストパラメーター

リクエストメソッド: GET。 リクエストパラメーターは以下のとおりです。

edns_client_subnet パラメーターについて

edns_client_subnet パラメーターは、DNS ECS 機能 (RFC7871) をサポートしています。これは、より正確な DNS 名前解決とトラフィックの再ルーティングのために、ユーザーのサブネット情報を権威 DNS サーバーに渡します。長いサブネットマスクはより正確なアドレス情報を提供しますが、短いマスクはより良いユーザー プライバシーを提供します。サブネットマスクの長さは「/24」を推奨します。

type パラメーターでサポートされているタイプについて

認証パラメーター key を生成するためのアルゴリズム

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

// 注: プラス記号 (+) は文字列の連結を表し、実際の「+」文字ではありません。

この数式では、アカウント ID はアカウント ID の文字列値です。 たとえば、アカウント 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" Authority セクション。データが存在する場合、フォーマットは Answer フィールドと同じです
    //"Additional" Additional セクション。データが存在する場合、フォーマットは Answer フィールドと同じです
    // オプション "edns_client_subnet":"1.2.XX.XX/24"  
}

レスポンス値の説明

短縮モードのレスポンス例:

www.taobao.com を例として使用すると、A レコードをリクエストする場合、リクエスト URL は次のようになります。

https://223.5.5.5/resolve?name=domain&type=A&uid=AccountID&short=1&ak=AccessKey ID&key=****&ts=timestamp

レスポンスは次のようになります。

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

CNAME レコードをリクエストする場合、URL は次のようになります。

https://223.5.5.5/resolve?name=domain&type=CNAME&uid=AccountID&short=1&ak=AccessKey ID&key=****&ts=timestamp

レスポンスは次のようになります。

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

失敗したレスポンス

リクエストが失敗した場合、HTTP レスポンス ステータスコードは 4xx/5xx で、デバッグまたは問題報告のために特定のエラーコードが返されます。結果は JSON 形式で表されます。

失敗レスポンスの例:

{
 "code":"UrlParameterError"
}

エラーコードリスト