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

API de surveillance DNS - Détection gratuite des modifications DNS

Interroge les enregistrements DNS actuels d'un domaine et les compare à un instantané stocké lors de la vérification précédente. Renvoie une différence montrant quels types d'enregistrement ont changé, quelles étaient les valeurs précédentes et quelles sont les valeurs actuelles. Les instantanés sont stockés pendant 7 jours. Lors de la première vérification, l'état actuel est enregistré et aucun changement n'est signalé.

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

Détecter les modifications DNS non autorisées

Planifiez des vérifications périodiques sur vos domaines de production pour détecter le piratage DNS, les suppressions accidentelles d'enregistrements ou les modifications non autorisées. Déclenchez une alerte lorsque changes_detected est vrai.

Vérifier l'intégralité de la migration DNS

Après la migration des fournisseurs DNS, interrogez ce point de terminaison pour confirmer que tous les types d'enregistrement ont été mis à jour avec les nouvelles valeurs. Comparez les enregistrements actuels avec votre configuration attendue.

Surveiller les domaines concurrents ou partenaires

Suivez les modifications DNS sur les domaines tiers dont vous dépendez. Détectez lorsqu'un partenaire modifie ses enregistrements MX (changement de fournisseur de messagerie) ou A (migration d'hébergement).

Frequently asked questions

Combien de temps les instantanés sont-ils stockés ?

Les instantanés sont stockés pendant 7 jours. Si vous ne vérifiez pas un domaine dans les 7 jours, l'instantané précédent expire et la vérification suivante recommence sans données de comparaison.

Quels types d’enregistrements DNS sont pris en charge ?

A, AAAA, MX, TXT, NS, CNAME, SOA et PTR. Si vous omettez le paramètre types, l'ensemble par défaut (A, AAAA, MX, TXT, NS, CNAME) est vérifié.

Puis-je l'utiliser pour surveiller la disponibilité ?

Ce point de terminaison vérifie les enregistrements DNS, pas la disponibilité HTTP. Pour la surveillance de la disponibilité HTTP, utilisez plutôt le point de terminaison /v1/uptime/check.

Que se passe-t-il lors du premier contrôle ?

La première vérification stocke l'état actuel du DNS comme référence. Il renvoie changes_detected : false et previous_check : null. Les vérifications ultérieures se comparent à cette référence.

La comparaison est-elle sensible à la casse ?

Les valeurs des enregistrements DNS sont comparées telles quelles à partir du résolveur. Les valeurs des enregistrements sont triées avant comparaison, de sorte que les modifications de commande ne déclenchent pas à elles seules une détection de modification.

Get your API key

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