Skip to main content
Niniejszy dokument przedstawia sposób integracji API do zapytania o podstawowe informacje o karcie bankowej, które można wykorzystać do zapytania o podstawowe informacje o karcie bankowej.

​
Proces aplikacji

Aby skorzystać z API do zapytania o podstawowe informacje o karcie bankowej, 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 wywołania 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 za darmo; gdy limit się wyczerpie, możesz doładować saldo ogólne w konsoli.
📘 Pełna dokumentacja: API do zapytania o podstawowe informacje o karcie bankowej →

​
Podstawowe użycie

Najpierw zapoznaj się z podstawowym sposobem użycia, polegającym na wprowadzeniu numeru karty bankowej, aby uzyskać przetworzony wynik weryfikacji. Najpierw musisz przekazać prosty parametr bank_card, a następnie możemy wypełnić odpowiednie dane na interfejsie, jak pokazano na rysunku:

Możemy zobaczyć, ż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:
  • bank_card: numer karty bankowej.
  • encryption: opcjonalnie, 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:
Wynik zwrotny zawiera wiele pól, które są opisane poniżej:
  • result, kod wyniku weryfikacji, sytuacja dotycząca opłat przedstawia się następująco.
    • Kody wyników płatności:
      • 0: Zapytanie zakończone sukcesem
      • -1: Nie znaleziono informacji
    • Kody wyników bezpłatnych:
      • -2: Usługa centrum weryfikacji jest zajęta
      • -3: Karta bankowa nie istnieje
  • description, opis wyniku operacji.
  • account_bank, bank, w którym otwarto konto.
  • account_type, rodzaj karty: 1. karta debetowa; 2. karta kredytowa; 3. karta przedpłacona; 4. karta z możliwością kredytowania.
Można zauważyć, że podstawowe informacje o karcie bankowej zostały już uzyskane. 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łąd, API zwróci odpowiedni kod błędu i informację. Na przykład:
  • 400 token_mismatched: Zły wniosek, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 400 api_not_implemented: Zły wniosek, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 401 invalid_token: Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacji.
  • 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 do zapytania o podstawowe informacje o karcie bankowej w celu zapytania o podstawowe informacje o wprowadzonym numerze karty bankowej. 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.