Aktywna
Status usługi
Przed integracją sprawdź bieżący stan usługi i udokumentowane odpowiedzi na błędy.
Kategoria
DNS i infrastruktura
Punkty końcowe
3
Kluczowe funkcje
8
Często zadawane pytania
4
Używany przez ludzi w niesamowitych firmach
Sygnały zaufania przed integracją
Przejrzysta dokumentacja, uwierzytelnione żądania i widoczne informacje o niezawodności ułatwiają ocenę DomScan przed wdrożeniem.
OpenAPI
Materiały API
Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.
Klucze API
Chroniony dostęp
Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.
10,000
Darmowy limit
Zacznij od 10 000 kredytów miesięcznie i przejdź wyżej dopiero, gdy użycie wzrośnie.
Co ta API pomaga wdrożyć
Użyj tej strony jako briefu produkcyjnego: endpointy, przykłady, kształt odpowiedzi i elementy workflow potrzebne do podłączenia DomScan do produktu.
Osadzaj sprawdzanie domen, DNS intelligence, sygnały ryzyka lub enrichment w onboardingu, wyszukiwarce i narzędziach wewnętrznych.
Zastąp powtarzalne ręczne lookupy zadaniami cyklicznymi, alertami i odtwarzalnymi krokami dochodzenia.
Używaj przewidywalnych pól, udokumentowanych kodów statusu i kosztów kredytów zamiast scrapować strony dostawców.
Zasilaj agentów, dashboardy, playbooki SOAR i CRMy przez OpenAPI, SDK, Postman lub MCP.
Workflow integracji
Prosta ścieżka od pierwszego requestu do powtarzalnego użycia produkcyjnego.
Uwierzytelnij raz
Wyślij klucz API w udokumentowanym nagłówku i utrzymuj spójne requesty między usługami.
Odpytuj z przykładami
Zacznij od przykładów curl i HTTP, potem zmapuj parametry w kodzie aplikacji.
Operuj i monitoruj
Używaj kodów statusu, kosztów kredytów i pól odpowiedzi do retries, logów i alertów.
Zestaw developerski
Przejdź z tej strony do dokumentacji machine-readable, kolekcji requestów, SDK lub narzędzi agentowych.
Schemat OpenAPI
Generuj klientów lub sprawdzaj każdy kształt requestu i odpowiedzi.
Kolekcja PostmanImportuj gotowe requesty do testów manualnych i przekazania zespołowi.
SDK i CLIUżywaj utrzymywanych pakietów i workflow command-line zamiast pisać boilerplate.
Integracja MCPUdostępniaj domain intelligence agentom AI i wewnętrznym asystentom.
Mapa parametrów i odpowiedzi
Przejrzyj inputy, pola outputu i kody statusu przed podłączeniem endpointu do klienta.
Parametr
domaintypeexpecteddomains
Example Odpowiedź
domainrecord_typemeasurement_scopepercentage_basispropagation_percentagefully_propagatedconsistentunique_valuesresultssummarysummary.total_serverssummary.successful
Kody statusu HTTP
200400401402429
Punkty końcowe
GET
/v1/dns/propagation
domaintypeexpected
POST
/v1/dns/propagation/bulk
domainstypeexpected
GET
/v1/dns/servers
Sygnały zaufania przed integracją
Przejrzysta dokumentacja, uwierzytelnione żądania i widoczne informacje o niezawodności ułatwiają ocenę DomScan przed wdrożeniem.
Status usługi
Materiały API
Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.
Klucze API
Chroniony dostęp
Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.
Darmowy limit
Zarejestruj się Bezpłatnie
Zacznij od 10 000 kredytów miesięcznie i przejdź wyżej dopiero, gdy użycie wzrośnie.
Aktywny
Przykład Request
Zacznij od przykładów curl i HTTP, potem zmapuj parametry w kodzie aplikacji.
Kluczowe funkcje
Dwaj niezależni dostawcy resolverów
Odpytuj Cloudflare i Google osobno, bez przełączania awaryjnego między dostawcami.
Wiele typów rekordów
Porównuj rekordy A, AAAA, CNAME, MX, TXT, NS i SOA.
Procent porównania
Zobacz największą grupę zgodnych odpowiedzi albo dokładne dopasowania expected, gdy podano tę wartość.
Zbieżność resolverów
Sprawdź, czy oba skonfigurowane resolvery zwróciły ten sam kanoniczny zestaw odpowiedzi.
Dopasowanie wartości expected
Opcjonalnie użyj dokładnej wartości rekordu expected jako podstawy procentu.
Zaobserwowane TTL
Sprawdź TTL zwrócony przez każdy resolver, który może odzwierciedlać bieżący stan jego pamięci podręcznej.
Czasy ze ścieżki żądania
Mierz czas odpowiedzi ze ścieżki żądania, a nie opóźnienie z regionów geograficznych.
Pochodzenie odpowiedzi resolvera
Zobacz dostawcę, zakres anycast, punkt końcowy DoH i dokumentację każdego resolvera.
Przykład Request
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/dns/propagation?domain=example.com&type=A"Example Odpowiedź
{
"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
}
}Często zadawane pytania
Co mierzy to porównanie resolverów?
Bez expected procent to liczebność największej grupy identycznych odpowiedzi podzielona przez oba skonfigurowane resolvery. Z expected jest to liczba dokładnych dopasowań podzielona przez dwa. fully_propagated oznacza tylko zgodność obu resolverów albo dopasowanie obu do expected. Błędy pozostają w mianowniku.
Dlaczego Cloudflare i Google mogą zwracać różne odpowiedzi?
Rekursywne resolvery utrzymują oddzielne pamięci podręczne. Różnice mogą wynikać z wygaśnięcia TTL, czasu cache, etapowych zmian autorytatywnych, równoważenia obciążenia, zasad DNS lub celowego różnicowania odpowiedzi. Rozbieżność nie musi oznaczać błędu.
Które usługi DNS są odpytywane?
API niezależnie odpytuje Cloudflare 1.1.1.1 i Google Public DNS przez ich punkty końcowe JSON DoH. Obaj są globalnymi rekursywnymi dostawcami anycast, a nie dwiema lokalizacjami geograficznymi.
Czy to dowodzi, że zmiana DNS rozpropagowała się na całym świecie?
Nie. Porównywani są dwaj publiczni rekursywni dostawcy ze ścieżki żądania. Aby uzyskać szersze dowody, odpytaj także bezpośrednio autorytatywne serwery nazw i wykonaj testy z ważnych dla Ciebie sieci lub regionów.
Narzędzia pokrewne i zasoby
Kody statusu HTTP
Dokumentujemy kody statusu HTTP, które powinien obsługiwać klient, aby można było odróżnić udane odpowiedzi, problemy z uwierzytelnianiem, kredyty, limity żądań, brakujące dane i błędy usług nadrzędnych.
OK
200
Żądanie zakończone pomyślnie
Nieprawidłowe żądanie
400
Nieprawidłowe parametry
Nieautoryzowany
401
Brakuje klucza API lub sesji albo są one nieprawidłowe.
Wymagana płatność
402
Za mało kredytów, aby wykonać to żądanie.
Zbyt wiele żądań
429
Przekroczono limit żądań
Porównaj odpowiedzi resolverów DNS