Aktywna
Status usługi
Przed integracją sprawdź bieżący stan usługi i udokumentowane odpowiedzi na błędy.
Dane internetowe
API walidacji ads.txt i sellers.json
Sprawdź, które firmy są upoważnione do sprzedaży powierzchni reklamowej witryny. Przeanalizuj ads.txt lub app-ads.txt, zgłoś nieprawidłowe linie i duplikaty oraz potwierdź każdego sprzedawcę w sellers.json systemu reklamowego.
Kategoria
Dane internetowe
Punkty końcowe
1
Kluczowe funkcje
4
Często zadawane pytania
4
Używany przez ludzi w tych 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
urlfileverify_sellers
Przykładowa odpowiedź
statussummarysummary.recordssummary.directsummary.resellersummary.ad_systemsvariablesvariables.ownerdomainissuessellerssellers.systems_checkedsellers.confirmed
Kody statusu HTTP
200400401402429
Punkty końcowe
GET
/v1/ads-txt
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ładowe żądanie
Zacznij od przykładów curl i HTTP, potem zmapuj parametry w kodzie aplikacji.
Kluczowe funkcje
ads.txt i app-ads.txt
Waliduj plik webowy lub wersję dla aplikacji mobilnych i telewizorów z dostępem do internetu, wraz z każdym rekordem, relacją i identyfikatorem urzędu certyfikacji.
Potwierdzanie sprzedawców
Przy verify_sellers=true każdy identyfikator sprzedawcy jest wyszukiwany w sellers.json systemu reklamowego i oznaczany jako potwierdzony, poufny, niezgodny typ (type_mismatch) lub nieznaleziony.
Kontrole składni
Nieprawidłowe linie, nieznane relacje, brakujące identyfikatory kont, błędne domeny i zduplikowane rekordy są zliczane wraz z numerami linii.
Zmienne
Deklaracje OWNERDOMAIN, MANAGERDOMAIN, CONTACT, SUBDOMAIN i INVENTORYPARTNERDOMAIN są zwracane w postaci, w jakiej je znaleziono.
Przykładowe żądanie
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/ads-txt?url=example.com&verify_sellers=true"Przykładowa odpowiedź
{
"status": "found",
"summary": { "records": 401, "direct": 94, "reseller": 307, "ad_systems": 98 },
"variables": { "ownerdomain": ["example.com"] },
"issues": [{ "code": "duplicate_record", "count": 47, "lines": [68, 76, 77] }],
"sellers": {
"systems_checked": 10,
"confirmed": 58,
"type_mismatch": 7,
"seller_not_found": 16,
"unknown": 9
}
}Często zadawane pytania
Co oznacza type_mismatch?
Plik sellers.json wymienia identyfikator sprzedawcy, ale z typem niezgodnym z relacją, na przykład wpis PUBLISHER dla linii RESELLER.
Dlaczego niektórzy sprzedawcy są nieznani?
Nie udało się odczytać pliku sellers.json systemu reklamowego, był zbyt duży lub miał nieprawidłowy format. Nieznany nigdy nie oznacza, że sprzedawcy brakuje.
Ile systemów reklamowych jest weryfikowanych?
Do 10 na żądanie, zaczynając od systemów z największą liczbą rekordów i relacji DIRECT.
Ile kredytów kosztuje?
Dwa kredyty lub pięć przy verify_sellers=true. Kredyty za wyniki kończące się jako status unknown są zwracane.
Narzędzia pokrewne i zasoby
Kody statusu HTTP
Oto kody statusu HTTP, które należy obsługiwać, aby 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ń
Waliduj ads.txt