Fazer solicitações | Documentação | Reverse DNS API | WhoisXML API

Fazer solicitações

Ponto de extremidade da API

POST https://reverse-dns.whoisxmlapi.com/api/v1
Leva até um minuto para ativar sua conta após o registro.

Coleção Postman

Postman é um aplicativo desktop e web que permite fazer solicitações a uma API a partir de uma interface gráfica de usuário. Recomendamos usar o Postman com endpoints de APIs WhoisXML ao explorar a funcionalidade das APIs, bem como ao solucionar problemas com seu aplicativo.

A coleção WhoisXML API Postman está disponível nos seguintes links:

A coleção inclui um ambiente pré-configurado. Você precisará configurar a api_key para disparar cada solicitação. Obtenha sua chave de API pessoal na página Meus produtos. Se você tiver dúvidas relacionadas à API, fale conosco.

A API retorna registros DNS que correspondem aos critérios de pesquisa fornecidos. Uma solicitação à API retorna registros DNS de um tipo, que deve ser especificado na variável recordType parâmetro de entrada.


Exemplo de corpo de solicitação

{
    "apiKey": "YOUR_API_KEY",
    "limit": 1000,
    "recordType": "soa",
    "terms": [
        {
            "field": "domain",
            "term": "google.com"
        }
    ]
}

Essa solicitação retorna todos os registros SOA para o domínio "google.com".

Você também pode usar a pesquisa curinga. Nesse caso, o termo tem a seguinte aparência "google*". Essas solicitações demoram mais para serem processadas, portanto, tente evitar pesquisas muito amplas.

Parâmetros de entrada

apiKey

Obrigatório. Obtenha sua chave de API pessoal na página Meus produtos.

recordType

Obrigatório. Tipo de registros DNS entre os quais a pesquisa é realizada.

Valores aceitáveis: soa | txt | cname

Padrão: indefinido

limit

Opcional. Contagem máxima de registros retornados.

Valores aceitáveis: 1 - 1000

Padrão: 1000

terms

Obrigatório. Conjunto de termos de pesquisa. Máximo de 4 itens.

terms.*.field

Obrigatório. O campo pelo qual a pesquisa é realizada entre os registros DNS recordType.

domain - Pesquisa de nome de domínio.

value - pesquisa de valor de registro DNS.

Valores aceitáveis: domínio | valor

terms.*.term

Obrigatório. O termo de pesquisa de destino.

termos.*.exclude

Opcional. Se for verdadeiro, os registros DNS correspondentes serão excluídos dos resultados da pesquisa.

Valores aceitáveis: false | true

Padrão: false

outputFormat

Opcional. Formato de saída da resposta.

Valores aceitáveis: JSON | XML

Padrão: JSON

Acesso gratuito

Após a inscrição, você recebe automaticamente um plano de assinatura gratuito limitado a 500 créditos DRS.

Limites de uso e limitação de solicitações

O número máximo de solicitações por segundo é 30. Caso o limite seja ultrapassado, suas solicitações subsequentes serão rejeitadas até o próximo segundo.

Essa API também está disponível com um balanceador de carga dedicado e um endpoint premium para permitir consultas mais rápidas como parte de nossos Premium API Services e Enterprise API Packages.