Skip to main content
Questo documento introduce un’API per l’identificazione e la verifica delle informazioni della carta d’identità, che può convalidare la veridicità e la coerenza del nome e del numero della carta d’identità inserendo un’immagine della carta d’identità o il nome e il numero della carta d’identità. Questa interfaccia è utilizzata per convalidare la veridicità e la coerenza del nome e del numero della carta d’identità; è possibile fornire le informazioni necessarie inserendo il nome e il numero della carta d’identità o inviando una foto del lato anteriore della carta d’identità.

​
Processo di richiesta

Per utilizzare l’API di identificazione e verifica delle informazioni della carta d’identità, prima di tutto, vai al Pannello di controllo di Ace Data Cloud per ottenere il tuo API Token, da conservare per uso futuro. Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e a effettuare il login; una volta completato, verrai riportato automaticamente alla pagina corrente. Un API Token è sufficiente per accedere a tutti i servizi della piattaforma, senza dover richiedere separatamente per ogni servizio. La prima richiesta include un credito gratuito, che consente di provare gratuitamente; quando il credito è insufficiente, puoi ricaricare il saldo generale nel pannello di controllo.
📘 Documentazione completa: API di identificazione e verifica delle informazioni della carta d’identità →

​
Utilizzo di base

Per prima cosa, è necessario comprendere il modo di utilizzo di base, che consiste nell’inserire il link all’immagine della carta d’identità per ottenere il risultato di verifica elaborato; è necessario semplicemente passare un campo image_url, e possiamo quindi compilare il contenuto corrispondente nell’interfaccia, come mostrato nell’immagine:

Possiamo vedere che qui abbiamo impostato le intestazioni della richiesta, tra cui:
  • accept: il formato di risposta desiderato, 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:
  • image_url: il link all’immagine della carta d’identità da elaborare.
  • encryption: opzionale, parametro di crittografia per campi sensibili (se è necessario inviare dati crittografati).
Dopo aver effettuato la selezione, possiamo notare che a destra è stato generato il codice corrispondente, come mostrato nell’immagine:

Cliccando sul pulsante “Prova” è possibile effettuare un test; come mostrato nell’immagine sopra, abbiamo ottenuto il seguente risultato:
Il risultato restituito contiene diversi campi, descritti come segue:
  • result, codice del risultato di autenticazione, con le seguenti condizioni di costo.
    • Codici di risultato a pagamento:
      • 0: Nome e numero della carta d’identità corrispondono
      • -1: Nome e numero della carta d’identità non corrispondono
    • Codici di risultato non a pagamento:
      • -2: Numero della carta d’identità non valido (lunghezza, cifra di controllo, ecc. non corretti)
      • -3: Nome non valido (lunghezza, formato, ecc. non corretti)
      • -4: Servizio del database dei documenti anomalo
      • -5: Nessun record di questa carta d’identità nel database
      • -6: Sistema di confronto autorevole in fase di aggiornamento, riprovare più tardi
      • -7: Numero di autenticazioni superato il limite giornaliero.
  • description, risultato della verifica tra nome e numero della carta d’identità.
  • name, informazioni sul nome nella carta d’identità; se non è stata caricata l’immagine della carta d’identità, sarà vuoto.
  • id_card, informazioni sul numero della carta d’identità; se non è stata caricata l’immagine della carta d’identità, sarà vuoto.
  • sex, informazioni sul sesso nella carta d’identità; se non è stata caricata l’immagine della carta d’identità, sarà vuoto.
  • nation, informazioni sulla nazionalità nella carta d’identità; se non è stata caricata l’immagine della carta d’identità, sarà vuoto.
  • birth, informazioni sulla data di nascita nella carta d’identità; se non è stata caricata l’immagine della carta d’identità, sarà vuoto.
  • address, informazioni sull’indirizzo di residenza nella carta d’identità; se non è stata caricata l’immagine della carta d’identità, sarà vuoto.
Si può notare che le informazioni sul nome e sul numero della carta d’identità sono coerenti e valide, e sono state estratte anche altre informazioni utilizzando la tecnologia OCR e mostrate. Inoltre, se si desidera generare il codice di integrazione corrispondente, è possibile copiarlo direttamente, ad esempio il codice CURL è il seguente:
Il codice di integrazione in Python è il seguente:

​
Verifica delle informazioni personalizzate

Offriamo anche un modo per verificare senza rivelare le informazioni dell’immagine della carta d’identità; è possibile semplicemente inserire il nome name e il numero della carta d’identità id_card per convalidare la veridicità e la coerenza del nome e del numero della carta d’identità; di seguito sono riportate le informazioni specifiche inserite:

Cliccando su “Esegui” si ottiene il seguente risultato:
In questo modo, dal risultato non vengono rivelate altre informazioni riservate, e si può comunque completare la verifica della veridicità e della coerenza del nome e del numero della carta d’identità.

​
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

​
Conclusione

Attraverso questo documento, hai appreso come utilizzare l’API di identificazione e verifica delle informazioni della carta d’identità per convalidare la veridicità e la coerenza del nome e del numero della carta d’identità in base all’immagine o alle informazioni fornite. 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.