Tożsamość i weryfikacja 2 Punkty końcowe 7 Kluczowe funkcje

API: Walidacja numeru telefonu

Waliduj krajowe lub międzynarodowe numery telefonów, normalizuj ich formaty i dodawaj przydatny kontekst offline. Wyniki mogą obejmować lokalizację planu numeracyjnego, możliwe strefy czasowe, pierwotnego operatora prefiksu, wskazówki dotyczące wybierania, sygnały kodów krótkich i zgodne publiczne przydziały regulatora bez płatnego wyszukiwania telekomunikacyjnego.

Kategoria Tożsamość i weryfikacja
Punkty końcowe 2
Kluczowe funkcje 7
Często zadawane pytania 5

Używany przez ludzi w niesamowitych firmach

VercelLLM PulseOLXCasa ModernaPipeCal.comBeehiivSnykTogglRemoteSprigDeel

Sygnały zaufania przed integracją

Przejrzysta dokumentacja, uwierzytelnione żądania i widoczne informacje o niezawodności ułatwiają ocenę DomScan przed wdrożeniem.

Aktywna Status usługi

Przed integracją sprawdź bieżący stan usługi i udokumentowane odpowiedzi na błędy.

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.

Workflow produktu

Osadzaj sprawdzanie domen, DNS intelligence, sygnały ryzyka lub enrichment w onboardingu, wyszukiwarce i narzędziach wewnętrznych.

Automatyzacja analityków

Zastąp powtarzalne ręczne lookupy zadaniami cyklicznymi, alertami i odtwarzalnymi krokami dochodzenia.

Czyste dane JSON

Używaj przewidywalnych pól, udokumentowanych kodów statusu i kosztów kredytów zamiast scrapować strony dostawców.

AI i narzędzia ops

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.

1
Uwierzytelnij raz

Wyślij klucz API w udokumentowanym nagłówku i utrzymuj spójne requesty między usługami.

2
Odpytuj z przykładami

Zacznij od przykładów curl i HTTP, potem zmapuj parametry w kodzie aplikacji.

3
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.

Mapa parametrów i odpowiedzi

Przejrzyj inputy, pola outputu i kody statusu przed podłączeniem endpointu do klienta.

Parametry requestu

Parametr

phonedefault_countryexpected_countrydialing_from_countrylanguagephones
Pola odpowiedzi

Example Odpowiedź

inputnormalized_inputkindvalidpossiblestatusrecommendationvalidation_levelreasonwarningsnumbernumber.e164
Zakres statusów

Kody statusu HTTP

200400401402429500

Punkty końcowe

POST /v1/phone/validate
Kredyty: 1Uwierzytelnianie: Uwierzytelnienie required
phonedefault_countryexpected_countrydialing_from_countrylanguage
POST /v1/phone/validate/bulk
Kredyty: 1/itemUwierzytelnianie: Uwierzytelnienie required
phonesdefault_countryexpected_countrydialing_from_countrylanguage

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.

Jeden kredyt za numer

Uruchom rutynowe kontrole planu numeracyjnego dla każdego numeru, zanim zdecydujesz, które rekordy uzasadniają bieżące wyszukiwanie sieciowe.

Bez zapytania telekomunikacyjnego dla każdego numeru

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.

Kontekst oficjalnych przydziałów

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.

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

Ścisła walidacja planu numeracyjnego

Sprawdzaj długość i wzorce cyfr względem pełnych metadanych planu numeracyjnego, a nie tylko długość.

Ustandaryzowane formaty

Zwracaj formaty E.164, międzynarodowy, krajowy i RFC 3966, w tym przeanalizowane numery wewnętrzne.

Możliwy a poprawny

Oddziel numery o wiarygodnej długości od zakresów rozpoznawanych przez plan numeracyjny.

Typ numeru i informacje o prefiksie

Rozpoznawaj typ numeru, lokalizację planu numeracyjnego, możliwe strefy czasowe, pierwotnego operatora prefiksu i obsługę przenoszenia, gdy metadane je zawierają.

Wybieranie zależne od kraju i kody krótkie

Analizuj numery krajowe z krajem, generuj formaty wybierania zależne od miejsca pochodzenia oraz rozpoznawaj regionalne kody krótkie i numery alarmowe.

Walidacja zbiorcza

Waliduj do 100 numerów w jednym żądaniu, zwracając osobny wynik dla każdego wejścia.

Źródła offline i oficjalne przydziały

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

POST /v1/phone/validate bash
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ź

200 OK json
{
  "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

Co oznacza prawidłowy numer telefonu?

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.

Czy walidacja dowodzi, że numer jest aktywny lub osiągalny?

Nie. Walidacja planu numeracyjnego nie potwierdza, że numer jest przypisany, aktywny, osiągalny ani zdolny do odbierania połączeń lub SMS.

Czy API zwraca bieżącego operatora lub właściciela telefonu?

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.

Czy krajowe numery telefonów wymagają kraju?

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.

Czy mogę zbiorczo walidować numery telefonów?

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.

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ń

Błąd serwera 500

Błąd wewnętrzny

Wypróbuj bezpłatne informacje o numerach telefonów