API de comparación de DNS recursivo

API de Comparación de servidores DNS recursivos

Compara las respuestas de Cloudflare y Google a través de sus respectivos endpoints DNS sobre HTTPS. Ambos son servicios recursivos con anycast global. El resultado muestra lo que devolvieron esos dos proveedores desde la ruta de la solicitud, no lo que se observa en todas las redes o regiones.

{ "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", ...

Categoría DNS y redes

Endpoints 3

Características principales 8

Preguntas frecuentes 4

Utilizado por personas en empresas increíbles.

Señales de confianza antes de integrar

Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.

En directo Estado del servicio

Consulta el estado del servicio en directo y las respuestas de error documentadas antes de integrar la API.

OpenAPI Artefactos de API

OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.

Claves API Acceso protegido

Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.

10,000 Créditos gratuitos

Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.

Qué te ayuda a lanzar esta API

Usa esta página como un resumen de producción: endpoints, ejemplos, forma de respuesta y piezas de flujo necesarias para integrar DomScan en tu producto.

Flujos de producto

Integra comprobaciones de dominios, inteligencia DNS, señales de riesgo o enriquecimiento en onboarding, búsqueda y herramientas internas.

Automatización de analistas

Sustituye consultas manuales repetidas por tareas programadas, alertas y pasos de investigación reproducibles.

Datos JSON limpios

Usa campos previsibles, códigos de estado documentados y costes de créditos en lugar de raspar páginas de proveedores.

IA y operaciones

Alimenta agentes, paneles, playbooks SOAR y CRMs mediante OpenAPI, SDK, Postman o MCP.

Flujo de integración

Un camino simple desde la primera solicitud hasta un uso repetible en producción.

Autentica una vez

Envía tu clave API con la cabecera documentada y mantén solicitudes coherentes entre servicios.

Consulta con ejemplos

Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.

Opera y monitoriza

Usa códigos de estado, costes de créditos y campos de respuesta para crear reintentos, logs y alertas.

Kit para desarrolladores

Salta desde esta página a documentación legible por máquinas, colecciones de solicitudes, SDKs o herramientas para agentes.

Esquema OpenAPI

Genera clientes o inspecciona cada forma de solicitud y respuesta.

Colección Postman

Importa solicitudes listas para pruebas manuales y traspaso al equipo.

SDKs y CLI

Usa paquetes mantenidos y flujos de línea de comandos en vez de escribir boilerplate.

Integración MCP

Expón inteligencia de dominios a agentes de IA y asistentes internos.

Mapa de parámetros y respuesta

Revisa entradas, campos de salida y códigos de estado antes de conectar el endpoint a tu cliente.

Parámetros de solicitud

Parámetro

domaintypeexpecteddomains

Campos de respuesta

Respuesta de ejemplo

domainrecord_typemeasurement_scopepercentage_basispropagation_percentagefully_propagatedconsistentunique_valuesresultssummarysummary.total_serverssummary.successful

Cobertura de estados

Códigos de estado HTTP

200400401402429

Endpoints

GET /v1/dns/propagation

Créditos: 2Autenticación: Autenticación requerida

domaintypeexpected

POST /v1/dns/propagation/bulk

Créditos: 2/itemAutenticación: Autenticación requerida

domainstypeexpected

GET /v1/dns/servers

Créditos: 0Autenticación: Autenticación requerida

Señales de confianza antes de integrar

Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.

Estado del servicio Artefactos de API

OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.

Claves API Acceso protegido

Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.

Créditos gratuitos Regístrate Gratis

Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.

Activo Solicitud de ejemplo

Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.

Características principales

Dos proveedores DNS recursivos independientes

Consulta Cloudflare y Google por separado, sin recurrir a un proveedor alternativo.

Varios tipos de registro

Compara registros A, AAAA, CNAME, MX, TXT, NS y SOA.

Porcentaje de comparación

Muestra el mayor grupo de respuestas coincidentes o las coincidencias exactas cuando se indica expected.

Convergencia de respuestas

Indica si ambos servidores DNS recursivos configurados devolvieron el mismo conjunto canónico de respuestas.

Coincidencia con el valor esperado

Permite usar un valor de registro esperado exacto como base del porcentaje.

TTL observados

Muestra el TTL que devuelve cada servidor DNS recursivo, que puede reflejar el estado actual de su caché.

Tiempos desde la ruta de la solicitud

Mide el tiempo de respuesta desde la ruta de la solicitud, no la latencia desde distintas regiones.

Procedencia de las respuestas

Muestra el proveedor, el alcance anycast, el endpoint DoH y la documentación de cada servicio.

Solicitud de ejemplo

GET /v1/dns/propagation bash

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

Respuesta de ejemplo

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
  }
}

Preguntas frecuentes

¿Qué mide esta comparación?

Sin expected, el porcentaje es el mayor grupo de respuestas idénticas dividido entre los dos servidores DNS recursivos configurados. Con expected, es el número de coincidencias exactas dividido entre ambos. fully_propagated solo indica que los dos convergen o que ambos coinciden con expected.

¿Por qué Cloudflare y Google pueden devolver respuestas distintas?

Cada servicio DNS recursivo mantiene su propia caché. Las diferencias pueden deberse a la caducidad del TTL, al momento en que se llenó la caché, a cambios escalonados en los servidores autoritativos, al balanceo de carga, a políticas DNS o a variaciones intencionadas. Una discrepancia no implica necesariamente un error.

¿Qué servicios DNS se consultan?

La API consulta de forma independiente Cloudflare 1.1.1.1 y Google Public DNS mediante sus endpoints JSON de DoH. Ambos son proveedores recursivos con anycast global, no dos ubicaciones geográficas.

¿Sirve para demostrar que un cambio DNS se ha propagado por todo el mundo?

No. Compara dos proveedores públicos de DNS recursivo desde la ruta de la solicitud. Para reunir más pruebas, consulta también los servidores autoritativos y realiza comprobaciones desde las redes o regiones que te interesen.

Herramientas y Recursos Relacionados

Códigos de estado HTTP

Documentamos los códigos de estado HTTP que debes gestionar para distinguir respuestas correctas, problemas de autenticación o créditos, límites de frecuencia, datos inexistentes y fallos del servicio de origen.

OK 200

Solicitud correcta

Solicitud incorrecta 400

Parámetros no válidos

No autorizado 401

Clave de API o sesión ausente o no válida.

Pago requerido 402

No tienes créditos suficientes para ejecutar esta solicitud.

Demasiadas solicitudes 429

Límite de frecuencia superado

Comparar respuestas DNS recursivas

Empezar gratis Ver documentación