Vai al contenuto principale
Questo documento introduce una verifica dei tre elementi del numero di telefono API, che può essere utilizzata per convalidare la veridicità e la coerenza del numero di telefono, del nome e del numero di carta d’identità.

​
Processo di richiesta

Per utilizzare l’API, è necessario prima andare alla pagina corrispondente Verifica dei tre elementi del numero di telefono API 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 accesso 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 l’API.

​
Utilizzo di base

Innanzitutto, è necessario comprendere il modo di utilizzo di base, ovvero inserire il numero di telefono per ottenere il risultato elaborato. È necessario semplicemente trasmettere un campo phone. 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:
  • name: il nome dell’utente da elaborare, è un parametro obbligatorio.
  • phone: il numero di telefono da elaborare, è un parametro obbligatorio.
  • id_card: il numero della carta d’identità dell’utente da elaborare, è un parametro obbligatorio.
  • verify_mode: modalità di verifica (lungo/corto).
  • encrypt_list/ciphertext_blob/iv: parametri di crittografia opzionali, per crittografare i campi sensibili secondo necessità.
Dopo aver selezionato, si può notare che a destra è stato generato il codice corrispondente, come mostrato nell’immagine:

Fare clic sul pulsante “Try” per eseguire il test, come mostrato nell’immagine sopra, e qui abbiamo ottenuto il seguente risultato: 
{
  "result": "0",
  "description": "Autenticazione riuscita",
  "isp": "Mobile",
  "result_detail": null
}
Il risultato restituito ha diversi campi, descritti come segue:
  • result, codice del risultato di autenticazione, la situazione di addebito è la seguente.
    • Codici di risultato a pagamento:
      • 0: Risultato della verifica coerente
      • 1: Risultato della verifica non coerente
    • Codici di risultato non a pagamento:
      • -1: Nessun record trovato
      • -2: Errore sconosciuto del motore
      • -3: Servizio del motore anomalo
      • -4: Verifica del nome non riuscita
      • -5: Numero di telefono non valido
      • -6: Numero di autenticazioni superato il limite giornaliero, riprovare il giorno successivo
  • description, descrizione del risultato aziendale.
Si può notare che le informazioni sulla veridicità e coerenza del numero di telefono, del nome e del numero di carta d’identità sono già state recuperate. 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/phone/check-3e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "name": "***",
  "phone": "***",
  "id_card": "***"
}'
Il codice di integrazione Python è il seguente: 
import requests

url = "https://api.acedata.cloud/identity/phone/check-3e"

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

payload = {
    "name": "***",
    "phone": "***",
    "id_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 compreso come utilizzare l’API di verifica dei tre elementi del numero di telefono per convalidare la veridicità e la coerenza del numero di telefono, del nome e del numero di carta d’identità. Speriamo che questo documento possa aiutarti a integrare e utilizzare meglio l’API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.