API OCR paspor Amerika Serikat

Cara mengenali paspor Amerika Serikat

Paspor Amerika Serikat mengikuti standar ICAO 9303: zona baca mesin dua baris berisi 44 karakter (format TD3) yang dicetak di bagian bawah halaman data, di bawah zona inspeksi visual yang dibaca manusia. Lima karakter pertamanya adalah P<USA – kode dokumen, lalu negara penerbit dalam kode ISO 3166-1 alpha-3 USA. API membaca kedua zona, memeriksa silang check digit MRZ, dan mengembalikan satu bentuk respons dengan setiap kunci selalu ada.

Amerika Serikat adalah US dalam daftar alpha-2 dan USA di dalam zona: di sini kode yang lebih panjang adalah kode yang lebih pendek ditambah A di belakangnya. Itu berlaku untuk pasangan ini, bukan sebagai aturan, jadi menurunkan kode yang satu dari yang lain adalah bug yang tinggal menunggu negara pertama yang tidak cocok.

Zona baca mesin yang diterbitkan oleh Amerika Serikat

9303 mendefinisikan tiga tata letak zona, dan API membaca ketiganya. Di bawah ini ada satu pemegang fiktif – ia bukan siapa-siapa, dan paradeigma adalah kata Yunani untuk contoh – dalam setiap tata letak, dengan USA sebagai negara penerbit. Setiap check digit dihitung dari karakter di sampingnya, bukan diketik manual, sehingga setiap zona di sini valid.

P<USAPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184USA9403084F3203101PN48291630<<<<72

I<USAPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<2

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

Tidak ada check digit yang mencakup negara penerbit: pada ketiga tata letak, perhitungannya mencakup nomor dokumen, tanggal-tanggal, dan data opsional, tidak pernah tiga karakter yang menyatakan siapa penerbit dokumen. Zona yang semua digitnya lolos belum membuktikan bahwa zona itu berasal dari Amerika Serikat – yang membuktikannya adalah zona visual dan fitur keamanan dokumen itu sendiri.

Tempelkan MRZ ke parser MRZ untuk memvalidasi check digit-nya, atau buat MRZ dengan generator MRZ.

Kolom yang Anda terima

Setiap paspor Amerika Serikat yang dikenali mengembalikan kolom terstruktur yang sama. Nilai yang tidak bisa dibaca adalah null, tidak pernah kunci yang hilang.

• Nama keluarga dan nama depan
• Tanggal lahir dan jenis kelamin
• Nomor dokumen dan nomor pribadi
• Kewarganegaraan dan negara penerbit (USA)
• Tanggal terbit dan tanggal kedaluwarsa, sisa hari
• Putusan MRZ, dan baris-baris tempat MRZ itu dibaca

Lihat setiap kolom di penjelajah kolom dokumen (dalam bahasa Inggris).

Lakukan panggilan

Jalankan ini terhadap sandbox publik – tanpa pendaftaran, pengenalan sungguhan, gratis untuk sejumlah dokumen terbatas dan 10 permintaan per jam per IP. Ganti kunci sandbox dengan kunci live Anda sendiri untuk terus mengenali paspor Amerika Serikat.

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')\"}"

Tempat hal ini didokumentasikan

Halaman ini membahas hal-hal yang khusus untuk Amerika Serikat. Empat halaman di bawah (dalam bahasa Inggris) memuat semua hal lainnya.

• Mengenali paspor

  Panggilan di atas dengan dokumen sungguhan, dalam curl, JavaScript, dan Python, dan setiap kunci jawabannya dijelaskan.

• MRZ dan zona visual

  Mengapa dokumen mencetak data yang sama dua kali, zona mana yang dipercaya jika keduanya berbeda, dan apa yang bisa dan tidak bisa dibuktikan oleh check digit di atas.

• Bahasa dan aksara kolom

  Zona baca mesin berupa transliterasi Latin; zona visual tidak. Pembacaan mana yang membawa aksara asli, dan bagaimana pengenal bahasa dipetakan ke sebuah bahasa.

• Error

  Setiap kode error yang bisa dijawab API, dalam satu tabel: apa penyebabnya, apakah percobaan ulang bisa berhasil, dan apakah panggilan itu ditagih.