API OCR per passaporti – Italia

Come si riconosce un passaporto – Italia

Un passaporto con paese di emissione Italia segue la norma ICAO 9303: una zona a lettura ottica di due righe da 44 caratteri (formato TD3) stampata in fondo alla pagina dei dati, sotto la zona di ispezione visiva destinata a chi legge. I suoi primi cinque caratteri sono P<ITA: il codice del documento e poi lo Stato di emissione con il codice ISO 3166-1 alfa-3 ITA. L'API legge entrambe le zone, verifica in modo incrociato le cifre di controllo della MRZ e restituisce un'unica struttura di risposta con tutte le chiavi presenti.

Paese: Italia. In un elenco alfa-2 il codice è IT, nella zona è ITA: qui il codice lungo è quello corto seguito da A. Vale per questa coppia e non come regola, quindi ricavare l'uno dall'altro è un bug che aspetta solo il primo paese in cui non funziona.

Zone a lettura ottica – paese di emissione: Italia

La 9303 definisce tre formati di zona, e l'API li legge tutti e tre. Qui sotto trovi una titolare inventata (non è nessuno, e paradeigma è la parola greca per esempio) in ciascun formato, con ITA come Stato di emissione. Ogni cifra di controllo è calcolata dai caratteri accanto a essa invece di essere digitata a mano, quindi ogni zona di questa pagina risulta valida.

P<ITAPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184ITA9403084F3203101PN48291630<<<<72

I<ITAPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<2

IDITAAK472913<4PN48291630<<<<<
9403084F3405204GRC<<<<<<<<<<<9
PARADEIGMA<<ELENI<SOFIA<<<<<<<

Nessuna cifra di controllo copre lo Stato di emissione: in tutti e tre i formati il calcolo riguarda il numero del documento, le date e i dati facoltativi, mai i tre caratteri che dicono chi ha emesso il documento. Una zona le cui cifre risultano tutte corrette non ha dimostrato di provenire dal paese indicato (Italia): lo fanno la zona visiva e gli elementi di sicurezza del documento stesso.

Incolla una MRZ nel parser MRZ per validarne le cifre di controllo, oppure creane una con il generatore MRZ.

I campi che ricevi

Ogni passaporto riconosciuto con paese di emissione Italia restituisce gli stessi campi strutturati. Un valore che non è stato possibile leggere è null, mai una chiave mancante.

• Cognome e nomi
• Data di nascita e sesso
• Numero del documento e numero personale
• Cittadinanza e Stato di emissione (ITA)
• Date di rilascio e di scadenza, giorni rimanenti
• Il verdetto sulla MRZ e le righe da cui è stata letta

Consulta tutti i campi nell'esploratore dei campi del documento (in inglese).

Fai la chiamata

Eseguila sulla sandbox pubblica: senza registrazione, con un riconoscimento reale, gratis per un numero limitato di documenti e 10 richieste all'ora per IP. Sostituisci la chiave della sandbox con la tua chiave di produzione per continuare a riconoscere passaporti con paese di emissione Italia.

curl -X POST https://api.doc.cheap/v1/scans \
  -H "Authorization: Bearer sk_sandbox_public" \
  -H "Content-Type: application/json" \
  -d "{\"image\": \"$(base64 < document.jpg | tr -d '\n')\"}"

Dove è documentato

Questa pagina tratta ciò che è specifico di questo paese (Italia). Le quattro pagine qui sotto (in inglese) coprono tutto il resto.

• Riconoscere un passaporto

  La chiamata qui sopra con un documento reale, in curl, JavaScript e Python, con ogni chiave della risposta spiegata.

• La MRZ e la zona visiva

  Perché un documento stampa gli stessi dati due volte, a quale zona credere quando non coincidono e cosa possono e non possono dimostrare le cifre di controllo.

• Lingue e scritture dei campi

  La zona è una traslitterazione latina; la zona visiva no. Quale lettura conserva la scrittura originale e come un identificatore di lingua viene ricondotto a una lingua.

• Errori

  Ogni codice di errore con cui l'API può rispondere, in un'unica tabella: cosa lo causa, se un nuovo tentativo può riuscire e se la chiamata è stata addebitata.