Skip to main content
W niniejszym dokumencie przedstawiono sposób integracji API weryfikacji trzech elementów numeru telefonu, które można wykorzystać do weryfikacji autentyczności i zgodności numeru telefonu, imienia i nazwiska oraz numeru dowodu osobistego.

​
Proces aplikacji

Aby skorzystać z API weryfikacji trzech elementów numeru telefonu, 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 kwota, aby można było skorzystać z bezpłatnej wersji próbnej; w przypadku niewystarczającej kwoty można doładować saldo ogólne w konsoli.
📘 Pełna dokumentacja: API weryfikacji trzech elementów numeru telefonu →

​
Podstawowe użycie

Najpierw zapoznaj się z podstawowym sposobem użycia, polegającym na wprowadzeniu numeru telefonu, aby uzyskać przetworzony wynik, najpierw musisz przekazać prosty parametr phone. Następnie możemy wypełnić odpowiednie pola 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ę i nazwisko użytkownika do przetworzenia, jest to parametr wymagany.
  • phone: numer telefonu do przetworzenia, jest to parametr wymagany.
  • id_card: numer dowodu osobistego użytkownika do przetworzenia, jest to parametr wymagany.
  • verify_mode: tryb weryfikacji (długi/krótki).
  • encrypt_list/ciphertext_blob/iv: opcjonalne parametry szyfrowania, szyfruj pola wrażliwe w razie potrzeby.
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, tutaj uzyskaliśmy następujący wynik:
Zwracany wynik zawiera wiele pól, które są opisane poniżej:
  • result, kod wyniku certyfikacji, sytuacja dotycząca opłat jest następująca.
    • Kody wyników płatnych:
      • 0: Wynik weryfikacji zgodny
      • 1: Wynik weryfikacji niezgodny
    • Kody wyników bezpłatnych:
      • -1: Brak rekordów
      • -2: Nieznany błąd silnika
      • -3: Nieprawidłowa usługa silnika
      • -4: Weryfikacja imienia i nazwiska nie powiodła się
      • -5: Numer telefonu jest nieprawidłowy
      • -6: Liczba certyfikacji przekroczyła dzienny limit, spróbuj ponownie następnego dnia
  • description, opis wyniku biznesowego.
Można zauważyć, że informacje dotyczące autentyczności i zgodności numeru telefonu, imienia i nazwiska oraz numeru dowodu osobistego zostały już sprawdzone. 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:

​
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 trzech elementów numeru telefonu do weryfikacji autentyczności i zgodności numeru telefonu, imienia i nazwiska oraz numeru dowodu osobistego. Mamy nadzieję, że ten dokument pomoże Ci lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań, skontaktuj się z naszym zespołem wsparcia technicznego.