Birleşik Krallık pasaportu için OCR API'si

Birleşik Krallık pasaportunu tanıma

Birleşik Krallık 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<GBR: önce belge kodu, ardından ISO 3166-1 alfa-3 koduyla düzenleyen devlet, GBR. 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: Birleşik Krallık. Alfa-2 listesindeki kodu GB, bölgedeki kodu GBR; burada uzun kod, kısa kodun sonuna R 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.

Birleşik Krallık 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 GBR 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<GBRPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184GBR9403084F3203101PN48291630<<<<72

I<GBRPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<2

IDGBRAK472913<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 Birleşik Krallık 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 Birleşik Krallık 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 (GBR)
• 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. Birleşik Krallık 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 Birleşik Krallık 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.