Amerika Birleşik Devletleri pasaportu için OCR API'si

Amerika Birleşik Devletleri pasaportunu tanıma

Amerika Birleşik Devletleri pasaportu ICAO 9303 standardına uyar: veri sayfasının altına, insanların okuduğu görsel inceleme bölgesinden ayrı olarak basılmış, iki satır ve 44 karakterlik bir makinede okunabilir bölge (format TD3). İlk beş karakteri P<USA: önce belge kodu, ardından ISO 3166-1 alfa-3 koduyla düzenleyen devlet, USA. API iki bölgeyi de okur, MRZ kontrol basamaklarını çapraz kontrol eder ve her anahtarın yer aldığı tek bir yanıt yapısı döndürür.

Ülke: Amerika Birleşik Devletleri. Alfa-2 listesindeki kodu US, bölgedeki kodu USA; burada uzun kod, kısa kodun sonuna A harfi eklenmiş hâlidir. Bu bir kural değildir, yalnızca bu çift için geçerlidir; dolayısıyla birini diğerinden türetmek, uymadığı ilk ülkeyi bekleyen bir hatadır.

Amerika Birleşik Devletleri tarafından düzenlenen makinede okunabilir bölgeler

9303 üç bölge düzeni tanımlar ve API üçünü de okur. Aşağıda uydurma bir hamil her düzende yer alıyor – gerçek biri değil; paradeigma Yunancada örnek demektir – ve düzenleyen devlet olarak USA görünüyor. Her kontrol basamağı elle yazılmak yerine yanındaki karakterlerden hesaplanır; bu yüzden buradaki her bölge doğrulamadan geçer.

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

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

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

Düzenleyen devleti hiçbir kontrol basamağı kapsamaz: üç düzende de aritmetik belge numarası, tarihler ve isteğe bağlı veriler üzerinden yapılır; belgeyi kimin düzenlediğini söyleyen üç karakter hiçbir zaman hesaba girmez. Tüm basamakları doğrulanan bir bölge, belgenin Amerika Birleşik Devletleri tarafından düzenlendiğini kanıtlamış olmaz – bunu görsel bölge ve belgenin kendi güvenlik unsurları yapar.

Kontrol basamaklarını doğrulamak için bir MRZ'yi MRZ ayrıştırıcıya yapıştırın ya da MRZ oluşturucu ile bir tane oluşturun.

Size dönen alanlar

Tanınan her Amerika Birleşik Devletleri pasaportu aynı yapılandırılmış alanları döndürür. Okunamayan bir değer null olur, asla eksik bir anahtar olmaz.

• Soyadı ve adlar
• Doğum tarihi ve cinsiyet
• Belge numarası ve kişisel numara
• Uyruk ve düzenleyen devlet (USA)
• Düzenlenme ve son geçerlilik tarihleri, kalan gün sayısı
• MRZ hükmü ve okunduğu satırlar

Tüm alanları belge alanı gezgininde görün.

Çağrıyı yapın

Bunu herkese açık sandbox'a karşı çalıştırın: kayıt yok, gerçek tanıma, sınırlı sayıda belge için ücretsiz ve IP başına saatte 10 istek. Amerika Birleşik Devletleri pasaportlarını tanımaya devam etmek için sandbox anahtarını kendi canlı anahtarınızla değiştirin.

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

Bunun belgelendiği yerler

Bu sayfa yalnızca Amerika Birleşik Devletleri ile ilgili özel noktaları kapsar. Geri kalan her şey aşağıdaki dört sayfadadır (İngilizce).

• Pasaport tanıma

  Yukarıdaki çağrı gerçek bir belgeyle; curl, JavaScript ve Python ile ve yanıtın her anahtarı tek tek açıklanarak.

• MRZ ve görsel bölge

  Bir belge neden aynı bilgileri iki kez basar, iki bölge uyuşmadığında hangisine güvenilir ve yukarıdaki kontrol basamakları neyi kanıtlayabilir, neyi kanıtlayamaz.

• Alanların dilleri ve yazı sistemleri

  Bölge Latin harfli bir transliterasyondur; görsel bölge değildir. Hangi okumanın özgün yazıyı taşıdığı ve bir dil tanımlayıcısının hangi dile karşılık geldiği.

• Hatalar

  API'nin döndürebileceği her hata kodu tek bir tabloda: neden oluştuğu, yeniden denemenin işe yarayıp yaramayacağı ve çağrının ücretlendirilip ücretlendirilmediği.