Skip to main content
W niniejszym dokumencie przedstawiono sposób integracji API rozpoznawania dowodu osobistego i weryfikacji informacji, które umożliwia weryfikację autentyczności i zgodności imienia oraz numeru dowodu osobistego na podstawie przesłanego zdjęcia dowodu osobistego lub imienia i numeru dowodu osobistego. Interfejs ten służy do weryfikacji autentyczności i zgodności imienia oraz numeru dowodu osobistego, można to zrobić, wprowadzając imię i numer dowodu osobistego lub przesyłając zdjęcie twarzy z dowodu osobistego.

​
Proces aplikacji

Aby skorzystać z API rozpoznawania dowodu osobistego i weryfikacji informacji, najpierw przejdź do konsoli Ace Data Cloud, aby uzyskać swój token API, który należy zachować na przyszłość. Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zakończeniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę. Jeden token API wystarczy do korzystania ze wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi. Przy pierwszym wniosku przyznawana jest darmowa pula, aby można było skorzystać z bezpłatnej wersji próbnej; w przypadku niewystarczającej puli można doładować saldo ogólne w konsoli.
📘 Pełna dokumentacja: API rozpoznawania dowodu osobistego i weryfikacji informacji →

​
Podstawowe użycie

Najpierw zapoznaj się z podstawowym sposobem użycia, polegającym na wprowadzeniu linku do zdjęcia dowodu osobistego, aby uzyskać przetworzony wynik weryfikacji. Należy najpierw przekazać pole image_url, a następnie można wypełnić odpowiednie dane na interfejsie, jak pokazano na rysunku:

Można zauważyć, że ustawiliśmy nagłówki żądania, w tym:
  • accept: format odpowiedzi, który chcemy otrzymać, tutaj wpisujemy application/json, czyli format JSON.
  • authorization: klucz do wywołania API, po złożeniu wniosku można go bezpośrednio wybrać z rozwijanej listy.
Dodatkowo ustawiono ciało żądania, w tym:
  • image_url: link do zdjęcia dowodu osobistego, które ma być przetworzone.
  • encryption: opcjonalny, parametr szyfrowania dla wrażliwych danych (jeśli wymagane jest przesłanie zaszyfrowanych danych).
Po dokonaniu wyboru można zauważyć, że po prawej stronie wygenerowano odpowiedni kod, jak pokazano na rysunku:

Klikając przycisk „Try”, można przeprowadzić test, jak pokazano na powyższym rysunku, otrzymujemy następujący wynik:
Zwracany wynik zawiera wiele pól, które są opisane poniżej:
  • result, kod wyniku weryfikacji, szczegóły opłat są następujące:
    • Kody wyników płatnych:
      • 0: Imię i numer dowodu osobistego są zgodne
      • -1: Imię i numer dowodu osobistego są niezgodne
    • Kody wyników bezpłatnych:
      • -2: Nieprawidłowy numer dowodu osobistego (nieprawidłowa długość, błąd kontrolny itp.)
      • -3: Nieprawidłowe imię (nieprawidłowa długość, format itp.)
      • -4: Błąd usługi bazy dokumentów
      • -5: Brak rekordu dowodu osobistego w bazie dokumentów
      • -6: System porównawczy w trakcie aktualizacji, spróbuj ponownie później
      • -7: Przekroczono dzienny limit weryfikacji.
  • description, wynik weryfikacji imienia i numeru dowodu osobistego.
  • name, informacja o imieniu na dowodzie osobistym, jeśli nie przesłano zdjęcia dowodu osobistego, będzie pusta.
  • id_card, informacja o numerze dowodu osobistego, jeśli nie przesłano zdjęcia dowodu osobistego, będzie pusta.
  • sex, informacja o płci na dowodzie osobistym, jeśli nie przesłano zdjęcia dowodu osobistego, będzie pusta.
  • nation, informacja o narodowości na dowodzie osobistym, jeśli nie przesłano zdjęcia dowodu osobistego, będzie pusta.
  • birth, informacja o dacie urodzenia na dowodzie osobistym, jeśli nie przesłano zdjęcia dowodu osobistego, będzie pusta.
  • address, informacja o adresie zamieszkania na dowodzie osobistym, jeśli nie przesłano zdjęcia dowodu osobistego, będzie pusta.
Można zauważyć, że informacje o imieniu i numerze dowodu osobistego są zgodne i ważne, a także wykorzystano technologię OCR do wydobycia innych informacji i ich wyświetlenia. Dodatkowo, jeśli chcesz wygenerować odpowiedni kod integracyjny, możesz go bezpośrednio skopiować, na przykład kod CURL wygląda następująco:
Kod integracyjny w Pythonie wygląda następująco:

​
Weryfikacja niestandardowych informacji

Oferujemy również sposób weryfikacji, który nie ujawnia informacji o zdjęciu dowodu osobistego, można przesłać tylko imię name i numer dowodu osobistego id_card, aby zweryfikować autentyczność i zgodność imienia oraz numeru dowodu osobistego. Poniżej znajdują się wprowadzone szczegółowe informacje:

Po kliknięciu „Uruchom” otrzymujemy następujący wynik:
W ten sposób z wyniku nie ujawniane są inne informacje prywatne, co również pozwala na weryfikację autentyczności i zgodności imienia oraz numeru dowodu osobistego.

​
Obsługa błędów

Podczas wywoływania API, jeśli wystąpią błędy, API zwróci odpowiedni kod błędu i informacje. Na przykład:
  • 400 token_mismatched: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 400 api_not_implemented: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 401 invalid_token: Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacyjny.
  • 429 too_many_requests: Zbyt wiele żądań, przekroczono limit.
  • 500 api_error: Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

​
Przykład odpowiedzi błędu

​
Wnioski

Dzięki temu dokumentowi zrozumiałeś, jak korzystać z API rozpoznawania dowodu osobistego i weryfikacji informacji, aby zweryfikować autentyczność i zgodność imienia oraz numeru dowodu osobistego na podstawie przesłanego zdjęcia lub informacji o imieniu i numerze dowodu osobistego. Mamy nadzieję, że ten dokument pomoże Ci lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań, prosimy o kontakt z naszym zespołem wsparcia technicznego.