POST AI agent ready /v1/dns-monitor/check

API de monitoramento de DNS - detecção gratuita de alterações de DNS

Consulta os registros DNS atuais de um domínio e os compara com um instantâneo armazenado da verificação anterior. Retorna uma comparação mostrando quais tipos de registro foram alterados, quais eram os valores anteriores e quais são os valores atuais. Os instantâneos são armazenados por 7 dias. Na primeira verificação, o estado atual é salvo e nenhuma alteração é relatada.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/dns-monitor/check \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","types":["A","MX","NS"]}'

When to use this API

Detecte alterações não autorizadas de DNS

Agende verificações periódicas em seus domínios de produção para detectar sequestro de DNS, exclusões acidentais de registros ou modificações não autorizadas. Acione um alerta quando changes_detected for verdadeiro.

Verifique a conclusão da migração de DNS

Após migrar os provedores de DNS, pesquise esse endpoint para confirmar se todos os tipos de registro foram atualizados para os novos valores. Compare os registros atuais com a configuração esperada.

Monitore domínios concorrentes ou parceiros

Rastreie alterações de DNS em domínios de terceiros dos quais você depende. Detecte quando um parceiro altera seus registros MX (troca de provedor de e-mail) ou registros A (migração de hospedagem).

Frequently asked questions

Por quanto tempo os instantâneos são armazenados?

Os instantâneos são armazenados por 7 dias. Se você não verificar um domínio dentro de sete dias, o instantâneo anterior expirará e a próxima verificação começará do zero, sem dados de comparação.

Quais tipos de registro DNS são suportados?

A, AAAA, MX, TXT, NS, CNAME, SOA e PTR. Se você omitir o parâmetro types, o conjunto padrão (A, AAAA, MX, TXT, NS, CNAME) será verificado.

Posso usar isso para monitoramento de tempo de atividade?

Este endpoint verifica os registros DNS, não a disponibilidade de HTTP. Para monitoramento de tempo de atividade HTTP, use o endpoint /v1/uptime/check.

O que acontece na primeira verificação?

A primeira verificação armazena o estado atual do DNS como linha de base. Ele retorna alterações_detectadas: falso e verificação anterior: nulo. As verificações subsequentes são comparadas com esta linha de base.

A comparação diferencia maiúsculas de minúsculas?

Os valores do registro DNS são comparados como estão no resolvedor. Os valores dos registros são classificados antes da comparação, portanto, as alterações de ordem por si só não acionam uma detecção de alterações.

Get your API key

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