Vai al contenuto principale
Questo documento presenterà un’API per la consultazione delle informazioni di base della carta bancaria, che può essere utilizzata per la consultazione delle informazioni di base della carta bancaria.

​
Processo di richiesta

Per utilizzare l’API, è necessario prima andare alla pagina corrispondente dell’API di consultazione delle informazioni di base della carta bancaria per richiedere il servizio corrispondente. Una volta entrati nella pagina, fare clic sul pulsante “Acquire”, come mostrato nell’immagine: Se non si è ancora effettuato il login o la registrazione, si verrà automaticamente reindirizzati alla pagina di login per invitare a registrarsi e accedere. Dopo aver effettuato il login o la registrazione, si tornerà automaticamente alla pagina corrente. Alla prima richiesta, verrà offerto un credito gratuito, che consente di utilizzare gratuitamente questa API.

​
Utilizzo di base

Innanzitutto, è necessario comprendere il modo di utilizzo di base, ovvero inserire il numero della carta bancaria per ottenere il risultato di verifica elaborato. È necessario semplicemente passare un campo bank_card, e possiamo quindi compilare il contenuto corrispondente nell’interfaccia, come mostrato nell’immagine:

Si può notare che qui abbiamo impostato le intestazioni della richiesta, tra cui:
  • accept: il formato della risposta desiderata, qui impostato su application/json, ovvero formato JSON.
  • authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dopo la richiesta.
Inoltre, abbiamo impostato il corpo della richiesta, che include:
  • bank_card: numero della carta bancaria.
  • encryption: opzionale, parametro di crittografia per i campi sensibili (se è necessario inviare il testo crittografato).
Dopo aver effettuato la selezione, si può notare che a destra è stato generato il codice corrispondente, come mostrato nell’immagine:

Cliccando sul pulsante “Try” è possibile effettuare un test, come mostrato nell’immagine sopra, e abbiamo ottenuto il seguente risultato: 
{
  "result": "0",
  "description": "Consultazione riuscita",
  "account_bank": "Banca Industriale e Commerciale della Cina",
  "account_type": 1
}
Il risultato restituito ha diversi campi, descritti come segue:
  • result, codice del risultato di autenticazione, la situazione dei costi è la seguente.
    • Codici di risultato a pagamento:
      • 0: Consultazione riuscita
      • -1: Nessuna informazione trovata
    • Codici di risultato senza costi:
      • -2: Servizio del centro di verifica occupato
      • -3: Carta bancaria inesistente
  • description, descrizione del risultato dell’operazione.
  • account_bank, banca di apertura del conto.
  • account_type, natura della carta: 1. Carta di debito; 2. Carta di credito; 3. Carta prepagata; 4. Carta di credito condizionata.
Si può notare che le informazioni di base della carta bancaria sono state consultate. Inoltre, se si desidera generare il codice di integrazione corrispondente, è possibile copiarlo direttamente, ad esempio il codice CURL è il seguente: 
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": "****"
}'
Il codice di integrazione in Python è il seguente: 
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)

​
Gestione degli errori

Quando si chiama l’API, se si verifica un errore, l’API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:
  • 400 token_mismatched: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 400 api_not_implemented: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 401 invalid_token: Non autorizzato, token di autorizzazione non valido o mancante.
  • 429 too_many_requests: Troppe richieste, hai superato il limite di frequenza.
  • 500 api_error: Errore interno del server, qualcosa è andato storto sul server.

​
Esempio di risposta di errore

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Conclusione

Attraverso questo documento, hai appreso come utilizzare l’API di consultazione delle informazioni di base della carta bancaria per consultare le informazioni di base della carta bancaria in base al numero di carta fornito. Speriamo che questo documento possa aiutarti a integrare e utilizzare meglio questa API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.