Aller au contenu
POST AI agent ready /v1/dns/lookup

API de recherche DNS - Requête d'enregistrement DNS gratuite

Interroge les enregistrements DNS d'un domaine à l'aide de Cloudflare DNS-over-HTTPS. Prend en charge les types d'enregistrement A, AAAA, MX, TXT, CNAME, NS, SOA et PTR.

Parameters

stringrequired

Domain name to look up.

string

DNS record type to query.

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

Vérifier la configuration du domaine lors de l'intégration

Lorsqu'un client ajoute un domaine personnalisé à votre plateforme SaaS, interrogez ses enregistrements CNAME ou A pour confirmer que le DNS pointe vers vos serveurs. Affichez une coche verte une fois que les enregistrements correspondent à vos valeurs attendues.

Surveiller les modifications des enregistrements MX pour la délivrabilité des e-mails

Planifiez des recherches MX périodiques pour votre domaine d'envoi afin de détecter les changements inattendus. Alertez votre équipe opérationnelle si un enregistrement MX est supprimé ou modifié, ce qui pourrait indiquer un détournement DNS ou une mauvaise configuration affectant la livraison des e-mails.

Auditer les enregistrements TXT pour vérifier la conformité SPF et DKIM

Interrogez les enregistrements TXT d'un domaine pour extraire les entrées SPF et DKIM. Analysez les valeurs pour vérifier qu'elles correspondent à votre configuration attendue et signalez les domaines avec des politiques manquantes ou trop permissives.

Frequently asked questions

Quel résolveur DNS ce point de terminaison utilise-t-il ?
Les requêtes passent par Cloudflare DNS-over-HTTPS (1.1.1.1). Cela permet une résolution rapide et respectueuse de la confidentialité sans mettre en cache les enregistrements obsolètes.
Quels types d'enregistrements sont pris en charge ?
A, AAAA, CNAME, MX, NS, TXT, SOA, SRV, CAA et PTR. Spécifiez le paramètre de type ; il est par défaut A s'il est omis.
Puis-je rechercher des sous-domaines ?
Oui. Transmettez le sous-domaine complet (par exemple "api.github.com") comme paramètre de domaine. Le point de terminaison résout la chaîne de domaine que vous fournissez.
Que représente query_time_ms ?
query_time_ms est le temps en millisecondes pris par la résolution DNS côté serveur. Il n'inclut pas le temps d'aller-retour réseau entre votre client et l'API.
Cela renvoie-t-il tous les enregistrements du type demandé ?
Oui. Si un domaine possède plusieurs enregistrements A ou plusieurs enregistrements MX, ils sont tous renvoyés dans le tableau records avec leurs valeurs TTL individuelles.

Get your API key

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

Sign up free View full docs