API OCR paspor Indonesia

Kirim foto paspor Indonesia dan terima data terstruktur dalam respons HTTP yang sama – zona baca mesin (MRZ) yang sudah diurai, check digit ICAO 9303 yang sudah diverifikasi, dan kolom-kolom visual yang sudah diekstrak. Tanpa SDK yang harus dipasang, tanpa antrean yang harus dipantau.

Cara mengenali paspor Indonesia

Paspor Indonesia 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<IDN – kode dokumen, lalu negara penerbit dalam kode ISO 3166-1 alpha-3 IDN. API membaca kedua zona, memeriksa silang check digit MRZ, dan mengembalikan satu bentuk respons dengan setiap kunci selalu ada.

Indonesia adalah ID dalam daftar alpha-2 dan IDN di dalam zona: di sini kode yang lebih panjang adalah kode yang lebih pendek ditambah N 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 Indonesia

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 IDN sebagai negara penerbit. Setiap check digit dihitung dari karakter di sampingnya, bukan diketik manual, sehingga setiap zona di sini valid.

TD3 – Paspor Indonesia

2 baris berisi 44 karakter. Kewarganegaraan IDN. Negara penerbit dan kewarganegaraan sama-sama IDN: paspor menyatakan kewarganegaraan dari negara yang menerbitkannya.

P<IDNPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184IDN9403084F3203101PN48291630<<<<72

TD2 – Dokumen perjalanan yang diterbitkan oleh Indonesia

2 baris berisi 36 karakter. Kewarganegaraan GRC. Diterbitkan oleh IDN untuk warga negara GRC, jadi kedua kode berbeda. Di sini nama berisi 31 karakter, bukan 39 seperti di paspor.

I<IDNPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<2

TD1 – Kartu identitas atau izin tinggal yang diterbitkan oleh Indonesia

3 baris berisi 30 karakter. Kewarganegaraan GRC. Tiga baris berisi 30 karakter, dengan nama di barisnya sendiri. Kode dokumennya ID – 9303 bagian 5 menetapkan karakter pertama sebagai A, C, atau I dan menyerahkan karakter kedua kepada negara penerbit.

IDIDNAK472913<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 Indonesia – yang membuktikannya adalah zona visual dan fitur keamanan dokumen itu sendiri.

Kolom yang Anda terima

Setiap paspor Indonesia 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 (IDN)
  • Tanggal terbit dan tanggal kedaluwarsa, sisa hari
  • Putusan MRZ, dan baris-baris tempat MRZ itu dibaca

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 Indonesia.

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 Indonesia. 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.

Mulai mengenali paspor Indonesia

Panggilan pertama yang berhasil dalam waktu kurang dari 60 detik, 1¢ per dokumen, dan gambar dokumen tidak pernah disimpan.

Anda hanya membayar dokumen yang benar-benar kami kenali.

Foto buram, tidak ada dokumen di dalam bingkai, jenis tidak dikenal – gratis. Anda tidak pernah membayar pemindaian yang gagal.