Türkiye pasaportu için OCR API'si

Türkiye pasaportunu tanıma

Türkiye 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<TUR: önce belge kodu, ardından ISO 3166-1 alfa-3 koduyla düzenleyen devlet, TUR. 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: Türkiye. Alfa-2 listesindeki kodu TR, bölgedeki kodu TUR; harf eklemekle birinden diğerine ulaşılamaz – TR, TUR kodunun öneki bile değildir. İki harfli kodu saklayan bir sistem, makinede okunabilir bölgenin gerçekte bastığı üç harfli koda ulaşmak için ISO 3166-1 tablosuna ihtiyaç duyar.

Türkiye 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 TUR 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<TURPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184TUR9403084F3203101PN48291630<<<<72

I<TURPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<2

IDTURAK472913<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 Türkiye 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 Türkiye 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 (TUR)
• 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. Türkiye 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 Türkiye 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.