Alibaba Cloud DNS:DoH JSON API

Resolva nomes de domínio por HTTPS usando a API JSON DoH, disponível em endpoints com e sem TLS.

Endpoints

• 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

Parâmetros da requisição

Método: GET. Parâmetros:

Sobre o parâmetro edns_client_subnet

O parâmetro edns_client_subnet implementa o dns ECS (RFC7871), transmitindo as informações de sub-rede do usuário para o dns autoritativo, o que garante uma resolução precisa e o redirecionamento de tráfego. Máscaras de sub-rede mais longas fornecem um endereçamento mais preciso, enquanto máscaras mais curtas melhoram a privacidade. Recomenda-se o uso de uma máscara de tamanho /24.

Sobre os tipos suportados para o parâmetro type

Algoritmo para gerar o parâmetro de autenticação key

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

Note: The plus sign (+) represents string concatenation, not the actual "+" character. 

O Account id é o valor em string do seu id de conta (por exemplo, "9**9"). O ts é o timestamp da requisição atual. O qname é o nome do domínio requisitado. Para gerar um par de AccessKey, siga Crie uma chave.

Exemplo de geração da key

Exemplo de requisição

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

Exemplo de resposta

{
    "Status":0,  
    "TC":false,
    "RD":true,
    "RA":true,
    "AD":false,
    "CD":false,
    "Question":{       // Request section
        "name":"www.taobao.com.",
        "type":1
    },
    "Answer":[         // Response section
        {
            "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 section, if data exists, format is the same as Answer field 
    //"Additional" Additional section, if data exists, format is the same as Answer field
    // Optional "edns_client_subnet":"1.2.XX.XX/24"  
}

Descrição dos valores de resposta

Exemplo de resposta no modo curto:

Exemplo de requisição de registro A para www.taobao.com:

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

Resposta:

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

Requisição de registro CNAME:

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

Resposta:

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

Resposta de falha

Requisições com falha retornam HTTP 4xx/5xx com um code de erro JSON para depuração ou relato de problemas.

Exemplo:

{
 "code":"UrlParameterError"
}

Lista de codes de erro