Skip to main content
Niniejszy dokument przedstawia sposób integracji z API weryfikacji danych osobowych i okresu ważności, które można wykorzystać do sprawdzenia autentyczności i zgodności imienia, numeru dowodu osobistego oraz okresu ważności dowodu.

​
Proces aplikacji

Aby skorzystać z API weryfikacji danych osobowych i okresu ważności, 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 otrzymasz darmowy limit, aby móc skorzystać z usługi; w przypadku niewystarczającego limitu można doładować saldo ogólne w konsoli.
📘 Pełna dokumentacja: API weryfikacji danych osobowych i okresu ważności →

​
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. Najpierw musisz przekazać prosty parametr name, a następnie możemy 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 chcesz otrzymać, tutaj wpisano 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:
  • name: imię.
  • id_card: numer dowodu osobistego.
  • image_url: link do zdjęcia twarzy, które ma być przetworzone.
  • validity_end: data wygaśnięcia ważności dowodu osobistego, format: YYYYMMDD, na długi okres użyj „00000000”;
  • validity_begin: data rozpoczęcia ważności dowodu osobistego, format: YYYYMMDD.
  • encryption: opcjonalnie, parametr szyfrowania dla wrażliwych danych (jeśli wymagana jest wysyłka zaszyfrowanych danych).
Po dokonaniu wyboru można zauważyć, że po prawej stronie wygenerowano odpowiedni kod, jak pokazano na rysunku:

Kliknij przycisk „Try”, aby przeprowadzić test, jak pokazano na powyższym rysunku, a otrzymamy następujący wynik:
Zwracany wynik zawiera wiele pól, które są opisane poniżej:
  • result, kod wyniku weryfikacji, szczegóły dotyczące 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 (długość, suma kontrolna itp. są niepoprawne)
      • -3: nieprawidłowe imię (długość, format itp. są niepoprawne)
      • -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: liczba weryfikacji przekroczyła dzienny limit.
  • description, wynik weryfikacji imienia i numeru dowodu osobistego.
Można zauważyć, że imię, numer dowodu osobistego oraz okres ważności dowodu osobistego są autentyczne i zgodne. 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:

​
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 weryfikacji danych osobowych i okresu ważności do sprawdzania autentyczności i zgodności imienia, numeru dowodu osobistego oraz okresu ważności dowodu. Mamy nadzieję, że ten dokument pomoże Ci lepiej zintegrować i korzystać z tego API. W przypadku jakichkolwiek pytań, prosimy o kontakt z naszym zespołem wsparcia technicznego.