API för jämförelse av DNS-resolverar och DNS-cachekontroll

API för Jämförelse av DNS-resolverar

Jämför svar från Cloudflare och Google via deras oberoende DNS-over-HTTPS-endpoints. Båda är globala rekursiva anycast-tjänster. Resultatet visar vad dessa två leverantörer svarade från anropsvägen, inte vad varje nätverk eller region ser.

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

Category DNS och infrastruktur

Slutpunkter 3

Nyckelfunktioner 8

Vanliga frågor 4

Används av människor på fantastiska företag

Förtroendesignaler före integration

Transparent dokumentation, autentiserade anrop och synliga tillförlitlighetsdetaljer gör DomScan lättare att utvärdera före lansering.

I drift Tjänstestatus

Kontrollera tjänstens aktuella status och dokumenterade felsvar innan du integrerar.

OpenAPI API-material

OpenAPI, Swagger, Postman, CLI, SDK och MCP-länkar finns ett klick bort.

API-nycklar Skyddad åtkomst

Autentiserade endpoints använder API-nycklar med tydliga kreditkostnader före anrop.

10,000 Gratis kvot

Börja med 10 000 krediter per månad och uppgradera först när användningen växer.

Vad detta API hjälper dig att leverera

Använd sidan som en produktionsbrief: endpoints, exempel, responsform och workflow-delar som krävs för att koppla DomScan till din produkt.

Produktworkflows

Bädda in domänkontroller, DNS-intelligence, risksignaler eller berikning i onboarding, sök och interna verktyg.

Analystautomatisering

Ersätt upprepade manuella lookups med schemalagda jobb, alerts och reproducerbara utredningssteg.

Ren JSON-data

Använd förutsägbara fält, dokumenterade statuskoder och kreditkostnader istället för att skrapa leverantörssidor.

AI- och ops-verktyg

Mata agenter, dashboards, SOAR-playbooks och CRM:er via OpenAPI, SDK, Postman eller MCP.

Integrationsworkflow

En enkel väg från första request till repeterbar produktion.

Autentisera en gång

Skicka din API-nyckel med dokumenterad header och håll requests konsekventa mellan tjänster.

Fråga med exempel

Börja med curl- och HTTP-exempel och mappa sedan parametrarna till din applikationskod.

Drifta och övervaka

Använd statuskoder, kreditkostnader och responsfält för retries, loggar och alerts.

Utvecklarkit

Gå från sidan till maskinläsbara docs, request-samlingar, SDK:er eller agentverktyg.

OpenAPI-schema

Generera klienter eller inspektera varje request- och responsform.

Postman-samling

Importera färdiga requests för manuell testning och teamöverlämning.

SDK:er och CLI

Använd underhållna paket och command-line workflows istället för boilerplate.

MCP-integration

Exponera domänintelligence för AI-agenter och interna assistentworkflows.

Parameter- och responskarta

Granska inputs, outputfält och statuskoder innan endpointen kopplas in i din klient.

Requestparametrar

Parameter

domaintypeexpecteddomains

Responsfält

Exempelsvar

domainrecord_typemeasurement_scopepercentage_basispropagation_percentagefully_propagatedconsistentunique_valuesresultssummarysummary.total_serverssummary.successful

Statustäckning

HTTP-statuskoder

200400401402429

Slutpunkter

GET /v1/dns/propagation

Krediter: 2Autentisering: Autentisering krävs

domaintypeexpected

POST /v1/dns/propagation/bulk

Krediter: 2/itemAutentisering: Autentisering krävs

domainstypeexpected

GET /v1/dns/servers

Krediter: 0Autentisering: Autentisering krävs

Förtroendesignaler före integration

Transparent dokumentation, autentiserade anrop och synliga tillförlitlighetsdetaljer gör DomScan lättare att utvärdera före lansering.

Tjänstestatus API-material

OpenAPI, Swagger, Postman, CLI, SDK och MCP-länkar finns ett klick bort.

API-nycklar Skyddad åtkomst

Autentiserade endpoints använder API-nycklar med tydliga kreditkostnader före anrop.

Gratis kvot Registrera dig Gratis

Börja med 10 000 krediter per månad och uppgradera först när användningen växer.

Aktiv Exempelbegäran

Börja med curl- och HTTP-exempel och mappa sedan parametrarna till din applikationskod.

Nyckelfunktioner

Två oberoende resolverleverantörer

Fråga Cloudflare och Google separat utan reservväg mellan leverantörerna.

Flera posttyper

Jämför poster av typerna A, AAAA, CNAME, MX, TXT, NS och SOA.

Jämförelseandel

Se den största gruppen med matchande svar, eller exakta träffar på expected när värdet anges.

Resolverkonvergens

Se om båda konfigurerade resolverarna returnerade samma kanoniska svarsmängd.

Träff på expected

Använd valfritt ett exakt postvärde i expected som grund för procentandelen.

Observerade TTL-värden

Granska TTL-värdet från varje resolver, vilket kan återspegla dess aktuella cachestatus.

Tider från anropsvägen

Mät svarstid från anropsvägen, inte latens från geografiska regioner.

Resolverursprung

Se leverantör, anycast-omfattning, DoH-endpoint och leverantörsdokumentation för varje resolver.

Exempelbegäran

GET /v1/dns/propagation bash

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

Exempelsvar

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

Vanliga frågor

Vad mäter den här resolverjämförelsen?

Utan expected är procentandelen den största gruppen med identiska svar dividerad med de två konfigurerade resolverarna. Med expected är den antalet exakta träffar dividerat med två. fully_propagated betyder endast att båda konvergerar eller matchar expected. Fel ligger kvar i nämnaren.

Varför kan Cloudflare och Google ge olika svar?

Rekursiva resolverar har separata cacheminnen. Skillnader kan bero på TTL-utgång, cachetid, stegvisa auktoritativa ändringar, lastbalansering, DNS-policy eller avsiktlig svarsvariation. En avvikelse är inte automatiskt ett fel.

Vilka DNS-tjänster frågas?

API:t frågar Cloudflare 1.1.1.1 och Google Public DNS oberoende via deras JSON DoH-endpoints. Båda är globala rekursiva anycast-leverantörer, inte två geografiska platser.

Kan detta bevisa att en DNS-ändring har spridits över hela världen?

Nej. Den jämför två publika rekursiva leverantörer från anropsvägen. För bredare belägg bör du också fråga de auktoritativa namnservrarna direkt och testa från de nätverk eller regioner som är viktiga för dig.

Relaterade verktyg och resurser

HTTP-statuskoder

Vi dokumenterar de HTTP-statuskoder som din klient bör hantera så att du kan skilja mellan lyckade svar, autentiseringsproblem, krediter, hastighetsgränser, saknade data och upstream-fel.

OK 200

Begäran lyckades

Felaktig begäran 400

Ogiltiga parametrar

Obehörig 401

API-nyckel eller session saknas eller är ogiltig.

Betalning krävs 402

Det finns inte tillräckligt med krediter för att köra denna begäran.

För många begäranden 429

Hastighetsgränsen överskriden

Jämför svar från DNS-resolverar

Borja gratis Visa dokumentation