Alibaba Cloud DNS：API JSON DoH

Titik akhir

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

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

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

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

Parameter permintaan

Metode permintaan: GET. Parameter permintaan adalah sebagai berikut:

Tentang parameter edns_client_subnet

Parameter edns_client_subnet mendukung fungsi ECS DNS (RFC7871), yang meneruskan informasi subnet pengguna ke DNS otoritatif untuk resolusi DNS yang lebih akurat dan pengalihan lalu lintas. Masker subnet yang lebih panjang memberikan informasi alamat yang lebih presisi, sementara masker yang lebih pendek menawarkan privasi pengguna yang lebih baik. Panjang masker subnet "/24" direkomendasikan.

Tentang tipe yang didukung untuk parameter type

Algoritma untuk menghasilkan parameter autentikasi key

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

Catatan: Tanda tambah (+) merepresentasikan penggabungan string, bukan karakter "+" yang sebenarnya. 

Dalam rumus ini, Account ID adalah nilai string dari ID akun Anda. Sebagai contoh, jika ID akun Anda adalah 9**9, string-nya adalah "9**9". ts adalah timestamp dari permintaan saat ini. qname adalah nama domain yang diminta. Untuk informasi selengkapnya tentang cara menghasilkan ID AccessKey dan Rahasia AccessKey, lihat Buat kunci.

Contoh pembuatan key

Permintaan contoh

Respon contoh

{
    "Status":0,  
    "TC":false,
    "RD":true,
    "RA":true,
    "AD":false,
    "CD":false,
    "Question":{       // Bagian permintaan
        "name":"www.taobao.com.",
        "type":1
    },
    "Answer":[         // Bagian respons
        {
            "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" Bagian otoritas, jika data ada, formatnya sama dengan bidang Answer 
    //"Additional" Bagian tambahan, jika data ada, formatnya sama dengan bidang Answer
    // Opsional "edns_client_subnet":"1.2.XX.XX/24"  
}

Deskripsi nilai respons

Contoh respons mode singkat:

Menggunakan www.taobao.com sebagai contoh, ketika meminta rekaman A, URL permintaannya adalah:

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

Responsnya adalah sebagai berikut:

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

Ketika meminta rekaman CNAME, URL-nya adalah:

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

Responsnya adalah sebagai berikut:

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

Tanggapan gagal

Ketika permintaan gagal, kode status respons HTTP adalah 4xx/5xx, dan kode kesalahan spesifik dikembalikan untuk debugging atau pelaporan masalah. Hasilnya direpresentasikan dalam format JSON.

Contoh respons gagal:

{
 "code":"UrlParameterError"
}

Daftar kode kesalahan