Live
Dienststatus
Prüfen Sie vor der Integration den aktuellen Dienstzustand und die dokumentierten Fehlerantworten.
Kategorie
DNS und Netzwerk
Endpunkte
3
Hauptfunktionen
8
Häufig gestellte Fragen
4
Wird von Menschen in großartigen Unternehmen verwendet
Vertrauenssignale vor der Integration
Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.
OpenAPI
API-Artefakte
OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.
API-Schlüssel
Geschützter Zugriff
Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.
10,000
Kostenloses Kontingent
Starte mit 10.000 monatlichen Credits und upgrade erst, wenn die Nutzung wächst.
Wobei diese API beim Bauen hilft
Nutze diese Seite als Produktionsbriefing: Endpoints, Beispiele, Antwortstruktur und Workflow-Bausteine, um DomScan in dein Produkt einzubinden.
Bette Domainchecks, DNS-Intelligence, Risikosignale oder Anreicherung in Onboarding, Suche und interne Tools ein.
Ersetze wiederholte manuelle Lookups durch geplante Jobs, Alerts und reproduzierbare Untersuchungsschritte.
Nutze vorhersehbare Felder, dokumentierte Statuscodes und Credit-Kosten statt Provider-Seiten zu scrapen.
Versorge Agenten, Dashboards, SOAR-Playbooks und CRMs über OpenAPI, SDK, Postman oder MCP.
Integrationsablauf
Ein einfacher Weg von der ersten Anfrage bis zur wiederholbaren Nutzung in Produktion.
Einmal authentifizieren
Sende deinen API-Schlüssel mit dem dokumentierten Header und halte Anfragen über Services hinweg konsistent.
Mit Beispielen abfragen
Starte mit den curl- und HTTP-Beispielen und übertrage die Parameter dann in deinen Anwendungscode.
Betreiben und überwachen
Nutze Statuscodes, Credit-Kosten und Antwortfelder, um Retries, Logs und Alerts zu bauen.
Developer-Kit
Wechsle von dieser Seite zu maschinenlesbaren Docs, Request-Sammlungen, SDKs oder Agenten-Tools.
OpenAPI-Schema
Generiere Clients oder prüfe jede Request- und Response-Struktur.
Postman-CollectionImportiere fertige Requests für manuelle Tests und Team-Handoff.
SDKs und CLINutze gepflegte Pakete und Kommandozeilen-Workflows statt Boilerplate zu schreiben.
MCP-IntegrationStelle Domain-Intelligence für KI-Agenten und interne Assistenten bereit.
Parameter- und Antwortkarte
Prüfe Eingaben, Ausgabefelder und Statuscodes, bevor du den Endpoint in deinen Client einbindest.
Parameter
domaintypeexpecteddomains
Beispielantwort
domainrecord_typemeasurement_scopepercentage_basispropagation_percentagefully_propagatedconsistentunique_valuesresultssummarysummary.total_serverssummary.successful
HTTP-Statuscodes
200400401402429
Endpunkte
GET
/v1/dns/propagation
domaintypeexpected
POST
/v1/dns/propagation/bulk
domainstypeexpected
GET
/v1/dns/servers
Vertrauenssignale vor der Integration
Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.
Dienststatus
API-Artefakte
OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.
API-Schlüssel
Geschützter Zugriff
Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.
Kostenloses Kontingent
Kostenlos Anmelden
Starte mit 10.000 monatlichen Credits und upgrade erst, wenn die Nutzung wächst.
Aktiv
Beispielanfrage
Starte mit den curl- und HTTP-Beispielen und übertrage die Parameter dann in deinen Anwendungscode.
Hauptfunktionen
Zwei unabhängige Resolver-Anbieter
Fragt Cloudflare und Google getrennt und ohne Rückgriff auf den jeweils anderen Anbieter ab.
Mehrere Datensatztypen
Überprüfen Sie A, AAAA, CNAME, MX, TXT, NS und SOA-Einträge.
Vergleichsprozentsatz
Zeigt die größte Gruppe übereinstimmender Antworten oder, falls expected angegeben ist, die exakten Übereinstimmungen mit diesem Wert.
Übereinstimmung der Resolver
Zeigt, ob beide konfigurierten Resolver dieselbe kanonische Antwortmenge zurückgegeben haben.
Abgleich mit erwartetem Wert
Verwendet optional einen exakten erwarteten Eintragswert als Grundlage für den Prozentsatz.
Beobachtete TTLs
Zeigt die TTL, die jeder Resolver zurückgegeben hat. Sie kann dessen aktuellen Cache-Zustand widerspiegeln.
Zeiten im Anfragepfad
Misst die Antwortzeit aus dem Anfragepfad, nicht die Latenz aus verschiedenen Regionen.
Herkunft der Resolver
Zeigt Anbieter, Anycast-Geltungsbereich, DoH-Endpunkt und Anbieterdokumentation für jeden Resolver.
Beispielanfrage
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/dns/propagation?domain=example.com&type=A"Beispielantwort
{
"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
}
}Häufig gestellte Fragen
Was misst dieser Resolver-Vergleich?
Ohne expected ist der Prozentsatz die größte Gruppe identischer Antworten geteilt durch beide konfigurierten Resolver. Mit expected ist er die Zahl der exakten Übereinstimmungen geteilt durch beide Resolver. Fehler bleiben im Nenner. fully_propagated bedeutet nur, dass beide Resolver übereinstimmen oder beide expected zurückgeben.
Warum können Cloudflare und Google unterschiedliche Antworten zurückgeben?
Rekursive Resolver führen getrennte Caches. Unterschiede können durch TTL-Ablauf, Cache-Zeitpunkte, schrittweise Änderungen an autoritativen Nameservern, Lastverteilung, DNS-Richtlinien oder bewusst unterschiedliche Antworten entstehen. Eine Abweichung ist nicht automatisch ein Fehler.
Welche DNS-Dienste werden abgefragt?
Die API fragt Cloudflare 1.1.1.1 und Google Public DNS unabhängig über deren JSON-DoH-Endpunkte ab. Beide sind globale rekursive Anycast-Anbieter, keine zwei geografischen Standorte.
Beweist dies, dass eine DNS-Änderung weltweit propagiert wurde?
Nein. Die API vergleicht zwei öffentliche rekursive Anbieter aus dem Anfragepfad. Für breitere Nachweise sollten Sie zusätzlich die autoritativen Nameserver direkt sowie die für Sie wichtigen Netzwerke oder Regionen testen.
Verwandte Tools & Ressourcen
HTTP-Statuscodes
Wir dokumentieren die HTTP-Statuscodes, die Ihr Client behandeln sollte, damit Sie erfolgreiche Antworten, Authentifizierungsprobleme, Credits, Ratenlimits, fehlende Daten und Upstream-Fehler unterscheiden können.
OK
200
Anfrage erfolgreich
Bad Request
400
Ungültige Parameter
Nicht autorisiert
401
API-Schlüssel oder Sitzung fehlt oder ist ungültig.
Zahlung erforderlich
402
Nicht genügend Credits für diese Anfrage.
Too Many Requests
429
Ratenlimit überschritten
Antworten von DNS-Resolvern vergleichen