API de comparaison des résolveurs DNS

Catégorie DNS et réseau

Points de terminaison 3

Fonctionnalités clés 8

Foire aux questions 4

Utilisé par les gens des meilleures entreprises

Signaux de confiance avant intégration

Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.

En direct État du service

Vérifiez l’état du service en direct et les réponses d’échec documentées avant de procéder à l’intégration.

OpenAPI Artefacts API

OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.

Clés API Accès protégé

Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.

10,000 Quota gratuit

Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.

Ce que cette API vous aide à livrer

Utilisez cette page comme brief de production : endpoints, exemples, structure de réponse et éléments de workflow pour intégrer DomScan à votre produit.

Workflows produit

Intégrez vérifications de domaines, intelligence DNS, signaux de risque ou enrichissement dans l’onboarding, la recherche et les outils internes.

Automatisation analyste

Remplacez les recherches manuelles répétées par des tâches planifiées, des alertes et des étapes d’enquête reproductibles.

Données JSON propres

Utilisez des champs prévisibles, des codes d’état documentés et des coûts en crédits au lieu de scraper des pages fournisseur.

IA et opérations

Alimentez agents, tableaux de bord, playbooks SOAR et CRMs via OpenAPI, SDK, Postman ou MCP.

Flux d’intégration

Un parcours simple de la première requête à un usage répétable en production.

Authentifier une fois

Envoyez votre clé API avec l’en-tête documenté et gardez des requêtes cohérentes entre services.

Interroger avec les exemples

Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.

Exploiter et surveiller

Utilisez codes d’état, coûts en crédits et champs de réponse pour construire retries, logs et alertes.

Kit développeur

Passez de cette page aux docs lisibles par machine, collections de requêtes, SDKs ou outils d’agents.

Schéma OpenAPI

Générez des clients ou inspectez chaque forme de requête et de réponse.

Collection Postman

Importez des requêtes prêtes pour les tests manuels et le transfert à l’équipe.

SDKs et CLI

Utilisez des packages maintenus et des workflows en ligne de commande au lieu d’écrire du boilerplate.

Intégration MCP

Exposez l’intelligence de domaines aux agents IA et aux assistants internes.

Carte des paramètres et réponses

Parcourez les entrées, champs de sortie et codes d’état avant de connecter l’endpoint à votre client.

Paramètres de requête

Paramètre

domaintypeexpecteddomains

Champs de réponse

Exemple de Réponse

domainrecord_typemeasurement_scopepercentage_basispropagation_percentagefully_propagatedconsistentunique_valuesresultssummarysummary.total_serverssummary.successful

Couverture des statuts

Codes de Statut HTTP

200400401402429

Points de terminaison

GET /v1/dns/propagation

Crédits: 2Authentification: Authentification requise

domaintypeexpected

POST /v1/dns/propagation/bulk

Crédits: 2/itemAuthentification: Authentification requise

domainstypeexpected

GET /v1/dns/servers

Crédits: 0Authentification: Authentification requise

Signaux de confiance avant intégration

Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.

État du service Artefacts API

OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.

Clés API Accès protégé

Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.

Quota gratuit Inscrivez-vous Gratuitement

Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.

Actif Exemple de Requête

Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.

Fonctionnalités clés

Deux fournisseurs indépendants

Interrogez Cloudflare et Google séparément, sans basculement vers l’autre fournisseur.

Plusieurs types d’enregistrement

Comparez les enregistrements A, AAAA, CNAME, MX, TXT, NS et SOA.

Pourcentage de comparaison

Affichez le plus grand groupe de réponses identiques ou les correspondances exactes lorsqu’expected est fourni.

Convergence des résolveurs

Vérifiez si les deux résolveurs configurés renvoient le même ensemble canonique de réponses.

Correspondance avec la valeur attendue

Utilisez facultativement une valeur d’enregistrement exacte comme base du pourcentage.

TTL observés

Consultez le TTL renvoyé par chaque résolveur, qui peut refléter l’état actuel de son cache.

Temps du chemin de requête

Mesurez le temps de réponse depuis le chemin de requête, pas la latence de différentes régions.

Provenance des réponses

Consultez le fournisseur, la portée anycast, le point de terminaison DoH et sa documentation.

Exemple de Requête

GET /v1/dns/propagation bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/dns/propagation?domain=example.com&type=A"

Exemple de Réponse

200 OK json

{
  "domain": "example.com",
  "record_type": "A",
  "measurement_scope": "configured_recursive_resolvers",
  "percentage_basis": "resolver_convergence",
  "propagation_percentage": 100,
  "fully_propagated": true,
  "consistent": true,
  "unique_values": ["93.184.216.34"],
  "results": [
    {
      "server": {
        "name": "Cloudflare 1.1.1.1",
        "ip": "1.1.1.1",
        "provider": "Cloudflare",
        "location": "Global anycast",
        "country": "GLOBAL",
        "scope": "global-anycast",
        "doh_endpoint": "https://cloudflare-dns.com/dns-query"
      },
      "success": true,
      "records": ["93.184.216.34"],
      "ttl": 86400,
      "response_time_ms": 12
    },
    {
      "server": {
        "name": "Google Public DNS",
        "ip": "8.8.8.8",
        "provider": "Google",
        "location": "Global anycast",
        "country": "GLOBAL",
        "scope": "global-anycast",
        "doh_endpoint": "https://dns.google/resolve"
      },
      "success": true,
      "records": ["93.184.216.34"],
      "ttl": 86400,
      "response_time_ms": 15
    }
  ],
  "summary": {
    "total_servers": 2,
    "successful": 2,
    "failed": 0,
    "matching_expected": 0
  }
}

Foire aux questions

Que mesure cette comparaison ?

Sans expected, le pourcentage correspond au plus grand groupe de réponses identiques divisé par les deux résolveurs configurés. Avec expected, il correspond au nombre de correspondances exactes divisé par deux. fully_propagated signifie seulement que les deux convergent ou correspondent à expected.

Pourquoi Cloudflare et Google peuvent-ils renvoyer des réponses différentes ?

Chaque résolveur récursif possède son propre cache. Les différences peuvent venir de l’expiration du TTL, du moment de mise en cache, de changements progressifs sur les serveurs faisant autorité, de la répartition de charge, d’une politique DNS ou d’une variation volontaire. Un écart ne signale pas forcément une erreur.

Quels services DNS sont interrogés ?

L’API interroge séparément Cloudflare 1.1.1.1 et Google Public DNS via leurs points de terminaison JSON DoH. Tous deux sont des services récursifs en anycast mondial, pas deux emplacements géographiques.

Cette comparaison prouve-t-elle qu’un changement DNS est propagé dans le monde entier ?

Non. Elle compare deux fournisseurs publics de résolution récursive depuis le chemin de requête. Pour obtenir des preuves plus larges, interrogez aussi les serveurs faisant autorité et testez depuis les réseaux ou régions qui vous intéressent.

Outils et Ressources Connexes

Codes de Statut HTTP

Nous documentons les codes d'état HTTP que votre client doit gérer afin de distinguer les réponses réussies, les problèmes d'authentification, les crédits, les limites de débit, les données introuvables et les erreurs en amont.

OK 200

Requête réussie

Requête incorrecte 400

Paramètres invalides

Non autorisé 401

Clé API ou session manquante ou invalide.

Paiement requis 402

Crédits insuffisants pour exécuter cette requête.

Trop de requêtes 429

Limite de débit dépassée

Comparer les réponses des résolveurs DNS

Commencer gratuitement Voir la documentation

Assistance

API de Comparaison des résolveurs DNS

Signaux de confiance avant intégration

Ce que cette API vous aide à livrer

Flux d’intégration

Kit développeur

Carte des paramètres et réponses

Points de terminaison

Signaux de confiance avant intégration

Fonctionnalités clés

Exemple de Requête

Exemple de Réponse

Foire aux questions

Outils et Ressources Connexes

Codes de Statut HTTP