POST AI agent ready /v1/dns/lookup

API de pesquisa de DNS - consulta gratuita de registros DNS

Consulta registros DNS de um domínio usando DNS sobre HTTPS da Cloudflare. Suporta tipos de registro A, AAAA, MX, TXT, CNAME, NS, SOA e PTR.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/dns/lookup \
  -H "Content-Type: application/json" \
  -d '{"domain":"github.com","type":"A"}'

When to use this API

Verifique a configuração do domínio durante a integração

Quando um cliente adiciona um domínio personalizado à sua plataforma SaaS, consulte seus registros CNAME ou A para confirmar se o DNS está apontando para seus servidores. Mostre uma marca de seleção verde quando os registros corresponderem aos valores esperados.

Monitore alterações no registro MX para capacidade de entrega de e-mail

Agende pesquisas MX periódicas para seu domínio de envio para detectar alterações inesperadas. Alerte sua equipe de operações se um registro MX for removido ou alterado, o que pode indicar um sequestro de DNS ou uma configuração incorreta que afeta a entrega de e-mails.

Audite registros TXT para conformidade com SPF e DKIM

Consulte registros TXT de um domínio para extrair entradas SPF e DKIM. Analise os valores para verificar se eles correspondem à configuração esperada e sinalize domínios com políticas ausentes ou excessivamente permissivas.

Frequently asked questions

Qual resolvedor de DNS esse endpoint usa?

As consultas passam pelo DNS sobre HTTPS da Cloudflare (1.1.1.1). Isso fornece uma resolução rápida e que respeita a privacidade, sem armazenar registros obsoletos em cache.

Quais tipos de registro são suportados?

A, AAAA, CNAME, MX, NS, TXT, SOA, SRV, CAA e PTR. Especifique o parâmetro de tipo; o padrão é A se omitido.

Posso procurar subdomínios?

Sim. Passe o subdomínio completo (por exemplo, "api.github.com") como parâmetro de domínio. O endpoint resolve qualquer string de domínio que você fornecer.

O que query_time_ms representa?

query_time_ms é o tempo em milissegundos que a resolução do DNS levou no lado do servidor. Não inclui o tempo de ida e volta da rede do seu cliente até a API.

Isso retorna todos os registros do tipo solicitado?

Sim. Se um domínio tiver vários registros A ou MX, todos eles serão retornados na matriz de registros com seus valores TTL individuais.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.