Tożsamość i weryfikacja

API do walidacji hiszpańskich numerów DNI, NIE i NIF

Waliduj hiszpańskie numery tożsamości i identyfikacji podatkowej w formularzach, rejestracji i fakturowaniu. API rozpoznaje numery DNI, NIE, K, L i M oraz NIF firm, sprawdza znak kontrolny i w razie niezgodności zwraca ten, który był oczekiwany.

Zobacz dokumentację Wypróbuj bezpłatne narzędzie Poznaj wszystkie API

Punkty końcowe Aktywny

GET /v1/national-id/validate

Przykładowe żądanie

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/national-id/validate?id=B58378431"

Przykładowa odpowiedź 200 OK

{
  "country": "ES",
  "normalized": "B58378431",
  "valid": true,
  "type": "cif",
  "entity_type": "sociedad_responsabilidad_limitada",
  "checks": { "format": true, "control": true },
  "expected_control": null,
  "errors": []
}

Przykładowe żądanie GET /v1/national-id/validate

Kluczowe funkcje 4

Często zadawane pytania 4

Kody statusu HTTP 200 / 400 / 401 / 402 / 429

Kategoria Tożsamość i weryfikacja

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.

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.

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 Postman

Importuj gotowe requesty do testów manualnych i przekazania zespołowi.

SDK i CLI

Używaj utrzymywanych pakietów i workflow command-line zamiast pisać boilerplate.

Integracja MCP

Udostę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.

Parametry requestu

Parametr

idcountry

Pola odpowiedzi

Przykładowa odpowiedź

countrynormalizedvalidtypeentity_typecheckschecks.formatchecks.controlexpected_controlerrors

Zakres statusów

Kody statusu HTTP

200400401402429

Punkty końcowe

GET /v1/national-id/validate

Kredyty: 1Uwierzytelnianie: Uwierzytelnienie required

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.

Kluczowe funkcje

Każdy hiszpański typ numeru

DNI, NIE, NIF typu K, L i M oraz NIF firm (dawniej CIF), każdy rozpoznawany według własnego formatu i zasad kontroli.

Oczekiwany znak kontrolny

Błędny ostatni znak wraca razem z prawidłowym, dzięki czemu możesz zasugerować poprawkę użytkownikowi.

Rodzaj firmy

NIF firm zwracają rodzaj podmiotu i wymuszają, czy dany rodzaj musi kończyć się literą, czy cyfrą.

Tolerancyjne dane wejściowe

Akceptowane są spacje, kropki, myślniki, małe litery, prefiks ES oraz 7-cyfrowe numery DNI bez wiodącego zera.

Przykładowe żądanie

GET /v1/national-id/validate?id=B58378431 bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/national-id/validate?id=B58378431"

Przykładowa odpowiedź

200 OK json

{
  "country": "ES",
  "normalized": "B58378431",
  "valid": true,
  "type": "cif",
  "entity_type": "sociedad_responsabilidad_limitada",
  "checks": { "format": true, "control": true },
  "expected_control": null,
  "errors": []
}

Często zadawane pytania

Czy prawidłowy wynik oznacza, że osoba lub firma istnieje?

Nie. Sprawdzenie dowodzi, że numer ma poprawną budowę i prawidłowy znak kontrolny. Nie dowodzi, że numer został wydany ani kto go posiada.

Czy mogę potwierdzić, że hiszpańska firma jest zarejestrowana jako podatnik VAT?

Tak. Wyślij NIF z prefiksem ES do API do walidacji VAT, które sprawdzi go na żywo w unijnym rejestrze VAT.

Czy jakieś dane są przechowywane lub udostępniane?

Nie. Sprawdzenie działa offline, a numer nigdy nie jest wysyłany do osób trzecich.

Ile kosztuje w kredytach?

Jeden kredyt za numer.

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ń

Zwaliduj DNI

Zacznij za darmo Zobacz dokumentację Wypróbuj bezpłatne narzędzie