API di confronto tra resolver DNS

Categoria DNS e rete

Endpoint 3

Caratteristiche Principali 8

Domande Frequenti 4

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

In tempo reale Stato del servizio

Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.

OpenAPI Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

10,000 Quota gratuita

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Cosa ti aiuta a costruire questa API

Usa questa pagina come brief di produzione: endpoint, esempi, forma della risposta e parti del workflow per integrare DomScan nel tuo prodotto.

Workflow di prodotto

Integra controlli dominio, intelligence DNS, segnali di rischio o arricchimento in onboarding, ricerca e strumenti interni.

Automazione per analisti

Sostituisci lookup manuali ripetuti con job pianificati, alert e passaggi di indagine riproducibili.

Dati JSON puliti

Usa campi prevedibili, codici di stato documentati e costi in crediti invece di fare scraping di pagine provider.

AI e strumenti ops

Alimenta agenti, dashboard, playbook SOAR e CRM tramite OpenAPI, SDK, Postman o MCP.

Workflow di integrazione

Un percorso semplice dalla prima richiesta all’uso ripetibile in produzione.

Autentica una volta

Invia la tua chiave API con l’header documentato e mantieni richieste coerenti tra servizi.

Interroga con esempi

Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.

Opera e monitora

Usa codici di stato, costi in crediti e campi di risposta per costruire retry, log e alert.

Kit sviluppatori

Passa da questa pagina a docs leggibili da macchina, raccolte di richieste, SDK o strumenti per agenti.

Schema OpenAPI

Genera client o ispeziona ogni forma di richiesta e risposta.

Collezione Postman

Importa richieste pronte per test manuali e handoff al team.

SDK e CLI

Usa pacchetti mantenuti e workflow da riga di comando invece di scrivere boilerplate.

Integrazione MCP

Esponi intelligence sui domini ad agenti AI e assistenti interni.

Mappa di parametri e risposta

Controlla input, campi di output e codici di stato prima di collegare l’endpoint al tuo client.

Parametri richiesta

Parametro

domaintypeexpecteddomains

Campi risposta

Risposta di esempio

domainrecord_typemeasurement_scopepercentage_basispropagation_percentagefully_propagatedconsistentunique_valuesresultssummarysummary.total_serverssummary.successful

Copertura stati

Codici di stato HTTP

200400401402429500502503504

Endpoint

GET /v1/dns/propagation

Crediti: 2Autenticazione: Autenticazione richiesta

domaintypeexpected

POST /v1/dns/propagation/bulk

Crediti: 2Autenticazione: Autenticazione richiesta

domainstypeexpected

GET /v1/dns/servers

Crediti: 0Autenticazione: Autenticazione richiesta

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

Stato del servizio Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

Quota gratuita Iscriviti Gratuitamente

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Attivo Richiesta di esempio

Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.

Caratteristiche Principali

Due provider indipendenti

Interroga separatamente Cloudflare e Google, senza fallback tra provider.

Più tipi di record

Confronta i record A, AAAA, CNAME, MX, TXT, NS e SOA.

Percentuale di confronto

Mostra il gruppo più numeroso di risposte identiche o le corrispondenze esatte quando viene fornito expected.

Convergenza dei resolver

Indica se entrambi i resolver configurati restituiscono lo stesso insieme canonico di risposte.

Corrispondenza con il valore atteso

Consente di usare un valore di record esatto come base della percentuale.

TTL osservati

Mostra il TTL restituito da ciascun resolver, che può riflettere lo stato attuale della sua cache.

Tempi dal percorso della richiesta

Misura il tempo di risposta dal percorso della richiesta del Worker, non la latenza da regioni diverse.

Provenienza delle risposte

Mostra provider, ambito anycast, endpoint DoH e documentazione di ciascun servizio.

Richiesta di esempio

GET /v1/dns/propagation bash

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

Risposta di esempio

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

Domande Frequenti

Che cosa misura questo confronto?

Senza expected, la percentuale è il gruppo più numeroso di risposte identiche diviso per i due resolver configurati. Con expected, è il numero di corrispondenze esatte diviso per due. fully_propagated indica solo che i due convergono o corrispondono entrambi a expected.

Perché Cloudflare e Google possono restituire risposte diverse?

Ogni resolver ricorsivo mantiene una cache separata. Le differenze possono dipendere dalla scadenza del TTL, dal momento di riempimento della cache, da modifiche graduali sui nameserver autorevoli, dal bilanciamento del carico, da criteri DNS o da variazioni intenzionali. Una differenza non indica necessariamente un errore.

Quali servizi DNS vengono interrogati?

L’API interroga separatamente Cloudflare 1.1.1.1 e Google Public DNS tramite i rispettivi endpoint JSON DoH. Entrambi sono servizi ricorsivi con anycast globale, non due località geografiche.

Questo confronto prova che una modifica DNS si è propagata in tutto il mondo?

No. Confronta due provider DNS ricorsivi pubblici dal percorso della richiesta del Worker. Per raccogliere prove più ampie, interroga anche i nameserver autorevoli ed esegui test dalle reti o regioni che ti interessano.

Strumenti e Risorse Correlati

Codici di stato HTTP

Documentiamo i codici di stato HTTP che il tuo client dovrebbe gestire per distinguere risposte riuscite, problemi di autenticazione, crediti, limiti di richiesta, dati mancanti ed errori upstream.

OK 200

Richiesta riuscita

Richiesta non valida 400

Parametri non validi

Non autorizzato 401

Chiave API o sessione mancante o non valida.

Pagamento richiesto 402

Crediti insufficienti per eseguire questa richiesta.

Troppe richieste 429

Limite di richieste superato

Errore del server 500

Errore interno

Gateway non valido 502

Errore RDAP upstream

Servizio non disponibile 503

Il servizio a monte non è disponibile o sta limitando temporaneamente le richieste.

Timeout del gateway 504

La richiesta al servizio a monte è scaduta.

Confronta le risposte dei resolver DNS

Inizia Gratis Consulta la documentazione

API per Confronto tra resolver DNS

Segnali di fiducia prima dell’integrazione

Cosa ti aiuta a costruire questa API

Workflow di integrazione

Kit sviluppatori

Mappa di parametri e risposta

Endpoint

Segnali di fiducia prima dell’integrazione

Caratteristiche Principali

Richiesta di esempio

Risposta di esempio

Domande Frequenti

Strumenti e Risorse Correlati

Codici di stato HTTP