Hoppa till huvudinnehåll
Denna artikel kommer att introducera en bankkortets grundläggande informationssökning API integration instruktioner, som kan användas för att söka efter grundläggande information om bankkort.

​
Ansökningsprocess

För att använda API:et måste du först gå till Bankkortets grundläggande informationssökning API motsvarande sida för att ansöka om den tjänst som behövs. När du kommer till sidan, klicka på knappen “Acquire”, som visas i bilden: Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan för att bjuda in dig att registrera dig och logga in. Efter att ha loggat in eller registrerat dig kommer du automatiskt att återvända till den aktuella sidan. Vid första ansökan kommer det att finnas en gratis kvot som ges, så att du kan använda detta API gratis.

​
Grundläggande användning

Först bör du förstå den grundläggande användningsmetoden, vilket är att ange bankkortets nummer för att få det bearbetade verifieringsresultatet. Först behöver du enkelt överföra ett bank_card fält, och vi kan sedan fylla i motsvarande innehåll på gränssnittet, som visas i bilden:

Här kan vi se att vi har ställt in Request Headers, inklusive:
  • accept: vilken format av svar du vill ta emot, här anges som application/json, det vill säga JSON-format.
  • authorization: nyckeln för att anropa API:et, som kan väljas direkt efter ansökan.
Dessutom har vi ställt in Request Body, inklusive:
  • bank_card: bankkortnummer.
  • encryption: valfritt, känsliga fält krypteringsparameter (om krypterad text behöver skickas).
När du har valt kan du se att motsvarande kod också har genererats till höger, som visas i bilden:

Klicka på knappen “Try” för att testa, som visas i bilden ovan, här har vi fått följande resultat: 
{
  "result": "0",
  "description": "Frågan lyckades",
  "account_bank": "Industrial and Commercial Bank of China",
  "account_type": 1
}
Det returnerade resultatet har flera fält, som beskrivs nedan:
  • result, autentiseringsresultatkod, avgiftsläget är som följer.
    • Avgiftsresultatkod:
      • 0: Frågan lyckades
      • -1: Ingen information hittades
    • Ingen avgiftsresultatkod:
      • -2: Verifieringscentret är upptaget
      • -3: Bankkortet finns inte
  • description, affärsresultatsbeskrivning.
  • account_bank, bank där kontot är öppnat.
  • account_type, korttyp: 1. Debetkort; 2. Kreditkort; 3. Förbetalt kort; 4. Förskott kreditkort.
Det kan ses att grundläggande information om bankkortet redan har sökts fram. Om du vill generera motsvarande integrationskod kan du direkt kopiera den som genererats, till exempel CURL-koden nedan: 
curl -X POST 'https://api.acedata.cloud/identity/bankcard/check-1e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "bank_card": "****"
}'
Python integrationskoden ser ut som följer: 
import requests

url = "https://api.acedata.cloud/identity/bankcard/check-1e"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "bank_card": "****"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
Felhantering

När du anropar API:et, om du stöter på fel, kommer API:et att returnera motsvarande felkod och information. Till exempel:
  • 400 token_mismatched: Bad request, kan bero på saknade eller ogiltiga parametrar.
  • 400 api_not_implemented: Bad request, kan bero på saknade eller ogiltiga parametrar.
  • 401 invalid_token: Obehörig, ogiltig eller saknad auktoriseringstoken.
  • 429 too_many_requests: För många förfrågningar, du har överskridit hastighetsgränsen.
  • 500 api_error: Intern serverfel, något gick fel på servern.

​
Exempel på felrespons

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "hämtning misslyckades"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Slutsats

Genom detta dokument har du fått en förståelse för hur man använder bankkortets grundläggande informationssökning API för att söka efter grundläggande information om det angivna bankkortnumret. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda detta API. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.