Przed integracją sprawdź bieżący stan usługi i udokumentowane odpowiedzi na błędy.
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.
Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.
Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.
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.
Wyślij klucz API w udokumentowanym nagłówku i utrzymuj spójne requesty między usługami.
Zacznij od przykładów curl i HTTP, potem zmapuj parametry w kodzie aplikacji.
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.
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
Example Odpowiedź
Kody statusu HTTP
Punkty końcowe
/v1/phone/validate
/v1/phone/validate/bulk
Najpierw waliduj. Za bieżące dane telekomunikacyjne płać tylko wtedy, gdy są potrzebne.
DomScan wykonuje pierwszy etap za pomocą walidacji planu numeracyjnego, standardowych formatów, metadanych offline i oficjalnych dowodów zakresu lub prefiksu, gdy są dostępne. Najpierw filtruj i kieruj numery, a dopiero potem dodawaj osobną usługę bieżącą, gdy decyzja zależy od aktualnego operatora, przenoszenia numeru, osiągalności, autoryzowanej weryfikacji tożsamości lub sygnałów oszustw dostawcy.
Uruchom rutynowe kontrole planu numeracyjnego dla każdego numeru, zanim zdecydujesz, które rekordy uzasadniają bieżące wyszukiwanie sieciowe.
DomScan sprawdza format, udokumentowane zakresy i metadane offline. Lokalizacja oznacza obszar planu numeracyjnego, a nie położenie fizyczne. Operator lub posiadacz przydziału to pierwotne powiązanie zakresu, niekoniecznie bieżący operator po przeniesieniu. Wynik nie potwierdza przypisania, aktywności, osiągalności, dostarczenia SMS ani tożsamości abonenta.
Gdy istnieje pokrycie, zobacz zgodny status zakresu i pierwotnego posiadacza przydziału wraz ze źródłem i szczegółami migawki. Opisuje to zakres, a nie bieżącego operatora ani abonenta.
Sygnały zaufania przed integracją
Przejrzysta dokumentacja, uwierzytelnione żądania i widoczne informacje o niezawodności ułatwiają ocenę DomScan przed wdrożeniem.
Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.
Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.
Zacznij od 10 000 kredytów miesięcznie i przejdź wyżej dopiero, gdy użycie wzrośnie.
Zacznij od przykładów curl i HTTP, potem zmapuj parametry w kodzie aplikacji.
Kluczowe funkcje
Sprawdzaj długość i wzorce cyfr względem pełnych metadanych planu numeracyjnego, a nie tylko długość.
Zwracaj formaty E.164, międzynarodowy, krajowy i RFC 3966, w tym przeanalizowane numery wewnętrzne.
Oddziel numery o wiarygodnej długości od zakresów rozpoznawanych przez plan numeracyjny.
Rozpoznawaj typ numeru, lokalizację planu numeracyjnego, możliwe strefy czasowe, pierwotnego operatora prefiksu i obsługę przenoszenia, gdy metadane je zawierają.
Analizuj numery krajowe z krajem, generuj formaty wybierania zależne od miejsca pochodzenia oraz rozpoznawaj regionalne kody krótkie i numery alarmowe.
Waliduj do 100 numerów w jednym żądaniu, zwracając osobny wynik dla każdego wejścia.
Gdy istnieje pokrycie, zobacz zgodny status zakresu i pierwotnego posiadacza przydziału wraz ze źródłem i szczegółami migawki. Opisuje to zakres, a nie bieżącego operatora ani abonenta.
Przykład Request
curl -X POST https://domscan.net/v1/phone/validate \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phone":"+34 612 345 678","expected_country":"ES","dialing_from_country":"US","language":"en"}'
Example Odpowiedź
{
"input": "+34 612 345 678",
"normalized_input": "+34 612 345 678",
"kind": "phone_number",
"valid": true,
"possible": true,
"status": "valid",
"recommendation": "accept",
"validation_level": "numbering_plan",
"reason": null,
"warnings": [],
"number": {
"e164": "+34612345678",
"international": "+34 612 34 56 78",
"national": "612 34 56 78",
"rfc3966": "tel:+34612345678",
"national_number": "612345678",
"extension": null,
"country": "ES",
"country_name": "Spain",
"country_calling_code": "34",
"possible_countries": ["ES"],
"country_match": true,
"type": "mobile",
"non_geographic": false
},
"intelligence": {
"status": "available",
"kind": "phone_number",
"coverage": {
"country": "ES",
"level": "official_allocation_match",
"global_numbering_metadata": true,
"official_snapshot_available": true,
"official_allocation_match": true,
"official_source_ids": ["cnmc"],
"matching_source_ids": ["cnmc"],
"current_carrier_lookup": false
},
"location": {
"country_name": "Spain",
"country": "ES",
"granularity": "country",
"current_physical_location": false
},
"possible_time_zones": {
"values": ["Europe/Madrid"],
"current_location": false,
"inference": "number_prefix"
},
"original_prefix_carrier": {
"name": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
"source_id": "cnmc",
"evidence": "official_allocation_record",
"current_carrier": false,
"portability_may_change_carrier": true
},
"portability": {
"region_supported": true,
"current_port_checked": false
},
"dialing": {
"from_country": "US",
"international": "011 34 612 34 56 78",
"internationally_diallable": true
},
"regulator_allocations": [{
"authority": "CNMC",
"category": "mobile",
"status": "assigned",
"original_assignee": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
"assigned_on": "2023-11-03",
"current_operator": false,
"individual_number_assignment_checked": false
}],
"sources": [{
"id": "google_libphonenumber",
"name": "Google libphonenumber metadata",
"license": "Apache-2.0"
}, {
"id": "cnmc",
"name": "Comisión Nacional de los Mercados y la Competencia (CNMC)",
"type": "official_regulator_snapshot"
}]
},
"live_checks": {
"assignment": "not_checked",
"reachability": "not_checked",
"current_carrier": "not_checked",
"subscriber_identity": "not_checked",
"porting": "not_checked"
},
"privacy": {
"upstream_requests": 0,
"telecom_provider_queried": false,
"persisted": false,
"domscan_edge_relay_used": true,
"third_party_requests": 0
},
"limitations": [
"NUMBERING_PLAN_ONLY",
"DOES_NOT_PROVE_ASSIGNMENT",
"NO_LIVE_TELECOM_CHECKS"
],
"credits_used": 1
}
Często zadawane pytania
Prawidłowy oznacza, że numer pasuje do udokumentowanej długości i wzorców cyfr rozpoznanego zakresu planu numeracyjnego. Nie oznacza to, że numer jest przypisany abonentowi.
Nie. Walidacja planu numeracyjnego nie potwierdza, że numer jest przypisany, aktywny, osiągalny ani zdolny do odbierania połączeń lub SMS.
API może zwrócić pierwotnego operatora prefiksu albo posiadacza przydziału regulatora. Żadne z tych pól nie oznacza bieżącego operatora po przeniesieniu numeru ani nie identyfikuje abonenta lub właściciela telefonu.
Tak. Podaj domyślny kraj lub region, gdy numer nie zaczyna się od międzynarodowego kodu kierunkowego. Kraj jest również wymagany do interpretacji regionalnych kodów krótkich i numerów alarmowych.
Tak. Endpoint zbiorczy przyjmuje do 100 numerów i zwraca wyniki w kolejności wejściowej. Jeśli wzbogacanie offline jest niedostępne, lokalna walidacja nadal się kończy, a intelligence.status zgłasza tryb awaryjny.
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.
Żądanie zakończone pomyślnie
Nieprawidłowe parametry
Brakuje klucza API lub sesji albo są one nieprawidłowe.
Za mało kredytów, aby wykonać to żądanie.
Przekroczono limit żądań
Błąd wewnętrzny
Wypróbuj bezpłatne informacje o numerach telefonów