> ## Documentation Index > Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # Weryfikacja czterech elementów karty bankowej API - instrukcja integracji > Identity Authentication 集成指南 - XHuoAPI W niniejszym dokumencie przedstawiono sposób integracji z API weryfikacji czterech elementów karty bankowej, które można wykorzystać do wprowadzenia numeru karty bankowej, imienia i nazwiska, numeru dokumentu tożsamości oraz numeru telefonu, aby sprawdzić autentyczność i spójność informacji. ## Proces aplikacji Aby skorzystać z API, należy najpierw przejść do odpowiedniej strony [API weryfikacji czterech elementów karty bankowej](https://api.xhuoapi.ai/documents/02f77369-ec7b-4218-a956-d7a84982a626) i złożyć wniosek o odpowiednią usługę. Po wejściu na stronę, kliknij przycisk „Acquire”, jak pokazano na obrazku: ![](https://cdn.xhuoapi.ai/q6ytrc.png) Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować. Po zalogowaniu lub rejestracji automatycznie wrócisz na bieżącą stronę. Podczas pierwszej aplikacji otrzymasz darmowy limit, który pozwala na bezpłatne korzystanie z tego API. ## Podstawowe użycie Najpierw zapoznaj się z podstawowym sposobem użycia, polegającym na wprowadzeniu numeru karty bankowej, aby uzyskać przetworzony wynik w postaci obrazu. Najpierw musisz przekazać prosty parametr `bank_card`. Następnie możemy wypełnić odpowiednie pola na interfejsie, jak pokazano na obrazku:

Możemy zobaczyć, że ustawiliśmy nagłówki żądania, w tym: * `accept`: w jakim formacie chcesz otrzymać odpowiedź, 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: * `bank_card`: numer karty bankowej do przetworzenia, jest to parametr obowiązkowy. * `id_card`: numer dokumentu tożsamości, jest to parametr obowiązkowy. * `name`: imię i nazwisko użytkownika, jest to parametr obowiązkowy. * `phone`: zarejestrowany numer telefonu. * `cert_type`: typ dokumentu tożsamości, musi być zgodny z dokumentem tożsamości. * `encryption`: opcjonalny, parametr szyfrowania dla wrażliwych pól (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 obrazku:

Kliknij przycisk „Try”, aby przeprowadzić test, jak pokazano na powyższym obrazku, a otrzymamy następujący wynik: ```json theme={null} { "result": "0", "description": "Autoryzacja zakończona sukcesem" } ``` Zwracany wynik zawiera wiele pól, które są opisane poniżej: * `result`, kod wyniku autoryzacji, sytuacja dotycząca opłat jest następująca. * Kody wyników płatnych: * 0: Autoryzacja zakończona sukcesem * -1: Autoryzacja nie powiodła się * -4: Błędne informacje o posiadaczu karty * -5: Nieaktywowana płatność bez karty * -6: Karta została zatrzymana * -7: Nieprawidłowy numer karty * -8: Ta karta nie ma odpowiadającego wydawcy * -9: Karta nie została zainicjowana lub jest w stanie uśpienia * -10: Karta oszukańcza, zatrzymana karta * -11: Ta karta została zgłoszona jako zgubiona * -12: Ta karta wygasła * -13: Karta z ograniczeniami * -14: Przekroczono dozwoloną liczbę błędów hasła * -15: Wydawca karty nie obsługuje tej transakcji * Kody wyników bezpłatnych: * -2: Weryfikacja imienia nie powiodła się * -3: Błędny numer karty bankowej * -16: Usługa centrum weryfikacji jest zajęta * -17: Przekroczono dozwoloną liczbę weryfikacji, spróbuj ponownie następnego dnia * `description`, opis wyniku biznesowego. Można zauważyć, że numer karty bankowej, imię i nazwisko, numer dokumentu tożsamości oraz numer telefonu mają autentyczność i spójność. Dodatkowo, jeśli chcesz wygenerować odpowiedni kod integracyjny, możesz go bezpośrednio skopiować, na przykład kod CURL wygląda następująco: ```shell theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/identity/bankcard/check-4e' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "name": "***", "phone": "***", "id_card": "***", "bank_card": "***" }' ``` Kod integracyjny w Pythonie wygląda następująco: ```python theme={null} import requests url = "https://api.xhuoapi.ai/v1/identity/bankcard/check-4e" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "name": "胡印福", "phone": "***", "id_card": "***", "bank_card": "***" } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ## 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 ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "pobieranie nie powiodło się" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## Wnioski Dzięki temu dokumentowi zrozumiałeś, jak korzystać z API weryfikacji czterech elementów karty bankowej do wprowadzenia numeru karty bankowej, imienia i nazwiska, numeru dokumentu tożsamości oraz numeru telefonu, aby sprawdzić autentyczność i spójność informacji. 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.