Veri çıkarma
Metin bloğu değil, yapılandırılmış alanlar döndüren bir OCR kimlik tarama API'si.
ShieldID, resmî bir fotoğraflı kimliği yapılandırılmış, alan bazlı verilere dönüştürür: ad, doğum tarihi, belge numarası, son kullanma tarihi, adres ve daha fazlası; her biri kendi kaynağını ve kendi kararını taşır. Aynı oturumda hem bir belge veri çıkarma API'si hem de bir belge doğrulama API'si.
Geri dönenler
Belgenin gerçekten taşıdığı yerde yapılandırılmış alanlar.
Her belge her alanı taşımaz. ShieldID belgenin sahip olduğunu döndürür, olmayanı da işaretler.
- Ad soyad
- Basılı hâliyle ve belgede varsa barkoda veya MRZ'ye kodlanmış hâliyle.
- Doğum tarihi
- Basılı yüzden okunur ve barkod ile MRZ'ye karşı çapraz kontrol edilir.
- Belge numarası
- Ehliyet numarası veya pasaport numarası; düzenleyicinin biçimi izin verdiği ölçüde iç tutarlılık açısından kontrol edilir.
- Son kullanma tarihi
- Basılı yüzden ve barkoddan veya MRZ'den okunur.
- Adres
- Basılı yüzden ve varsa barkoddan okunur; ayrıca ayrıca yüklenen bir adres belgesiyle karşılaştırılabilir.
- Cinsiyet
- Belgenin bastığı veya kodladığı yerde okunur.
- Düzenleyen yetki alanı
- Belgede tanınan bir veren kurum kodu bulunuyorsa, mevcut olduğu ölçüde barkodun veren kurum kodundan belirlenir.
Üç kaynak, tek karşılaştırma
Barkod, MRZ ve basılı ön yüz; tesadüfen karıştırılmak yerine bilinçli olarak okunur.
Her alan, geldiği kaynağa atfedilir. İki kaynak birbiriyle çeliştiğinde bu, iki değerin ortalaması alınmaz; sonuç üzerinde bir işaret olarak yer alır.
PDF417 barkodu
Kuzey Amerika ehliyetinin veya kimlik kartının arka yüzü, yapılandırılmış AAMVA alanlarına çözümlenir. Bir belgede barkod bulunduğunda, barkoddaki alanlar basılı ön yüze göre önceliklidir.
Pasaport MRZ
Makine tarafından okunabilir alan konumlandırılır, okunur ve alanın içine yerleştirilmiş ICAO kontrol hanesi formüllerine göre doğrulanır. Bu puana karşı denetlenen asgari bir geçerlilik puanı, MRZ'den okunan bir alana hiç güvenilip güvenilmeyeceğini belirler; kendi sağlama toplamında başarısız olan bir alan, daha temiz bir kaynağın önüne geçemez.
Ön yüzün yapılandırılmış ve tam sayfa OCR okuması
Basılı yüz, tanınan bir düzen varsa belgenin kendi düzeni kullanılarak okunur; tanıdık olmayan bir belgeden de okunabilir alanlar elde edilebilmesi için tam sayfa OCR'a geri dönülür.
Çelişkiler ortalaması alınmadan işaretlenir
Ön yüz, barkod ve MRZ arasında farklılık gösteren bir ad veya doğum tarihi, sonuçta uyumsuzluk olarak bildirilir. İşlem hattındaki hiçbir adım sessizce bir kazanan seçip çelişkiyi gizlemez.
MRZ sağlama toplamı doğrulaması
Makine tarafından okunabilir bir alan, güvenilmeden önce kendi hesabını doğrulamalıdır.
Pasaporttaki ICAO makine tarafından okunabilir alan, tasarımı gereği kontrol haneleri içerir. ShieldID, MRZ'den okunan bir alanı güvenilir saymadan önce bunları doğrular.
Özel bir dedektör MRZ'yi konumlandırır, bir okuyucu karakterleri çıkarır ve sonuç, alanın kendi sağlama toplamı formüllerine göre geçerlilik açısından puanlanır. Yalnızca asgari geçerlilik puanını aşan bir alana tam öncelikle güvenilir; kötü okunan bir alan ise temizmiş gibi aktarılmak yerine buna uygun şekilde ele alınır.
Önce barkod önceliği
Kaynaklar çakıştığında en güvenilir olan geçerli sayılır.
Aynı alan barkodda, MRZ'de ve basılı ön yüzde yer alabilir. ShieldID bunu her seferinde aynı tutarlı sıralamayla çözer.
- PDF417 barkodu
- Sağlama toplamını geçtikten sonra pasaport MRZ
- Basılı ön yüzün yapılandırılmış okunması
- Tam sayfa OCR yedeği
Adres belgeleri
İkinci bir belge yükleyin, doğrudan bir adres karşılaştırması alın.
Bir doğrulama adres kanıtı gerektirdiğinde başvuru sahibi ayrı bir belge yükler ve ShieldID bu belgeyi kimlik belgesini okuduğu şekilde okur.
Adres belgesi OCR işleminden geçirilir ve içindeki adres, kimlik belgesinden okunan adresle karşılaştırılır. Bu, ayrı bir belge sınıflandırıcısı değil, düz bir metin ve belirteç karşılaştırmasıdır; yalnızca oturum gerektirdiğinde ve gerçekten bir belge sağlandığında çalıştırılır.
Karartma ve kişisel verilerin işlenmesi
Çıkarılan veriler, görüntülerle aynı şekilde korunur.
Yapılandırılmış alanlar, kimlik fotoğraflarının kendisi için geçerli olan aynı gizlilik denetimleriyle birlikte tutulur.
Doğum tarihi beklemede şifrelenir
Doğum tarihi beklemede şifrelenmiş olarak saklanır; şifreleme anahtarı yerinde olmadan hizmet çalışmaz.
Görüntüler zamanlayıcıyla silinir
Yakalanan belge ve selfie görüntüleri, varsayılan olarak yedi gün olan kısa bir zamanlayıcıyla otomatik olarak silinir. Belirli aralıklarla ve her yeniden başlatmadan kısa süre sonra bir tarama çalışır; böylece sakin bir dönem, hiçbir görüntünün silinmesi gereken günü aşıp kalmasına yol açmaz.
Cihaz üzerinde puan karartma
Bir eşleşme veya güven değerinin başvuru sahibinin kendi telefonunda gösterileceği durumlarda ShieldID, bu mesaj görüntülenmeden önce temeldeki yüzdeyi çıkarır; böylece ham bir puan hesabınızın dışında asla görünmez.
Kayıt, görüntülerden daha uzun yaşar
Görüntüler bir takvime göre silinir. Bir doğrulamanın yapıldığı ve ne bulduğu bilgisi hesabınızda kalır; Trust Ledger entegrasyonu için ise Activity Ledger'da doğrulandı/başarısız kaydı olarak yer alır (ShieldID API hesapları için kayıt girdileri: Çok yakında).
Örnek sonuç
API'nin döndürdüğü yapıda, alan bazında kararlar.
Aşağıdaki adlar, numaralar ve adresler bu örnek için uydurulmuştur. Alan kümesi, kaynak bilgisi ve kararlar, bir sonucun gerçek yapısını yansıtır.
| Alan | Değer | Kaynak | Karar |
|---|---|---|---|
| person.name | "Maria Gonzalez" | barcode | match |
| person.dob | "1991-07-22" | barcode | match |
| person.document_number | "D1234567" | barcode | match |
| person.document_country | "US" | barcode issuer code | match |
| person.address | "1428 Elm St, Sacramento, CA" | barcode | match |
| identity.name_match | PASS | front vs barcode vs requester | PASS |
| checks.document_tamper | "no_indication" | advisory model | advisory, not gating |
// Sample result. Names, numbers and addresses are fictional.
{
"session_id": "ses_9f2c...sample",
"status": "VERIFIED",
"environment": "sandbox",
"person": {
"name": "Maria Gonzalez",
"dob": "1991-07-22",
"document_type": "DRIVERS_LICENCE",
"document_country": "US",
"document_jurisdiction": "CA",
"address": "1428 Elm St, Sacramento, CA"
},
"identity": {
"checks": ["name_match"],
"warnings": [],
"sources": {
"name": "barcode",
"dob": "barcode",
"address": "barcode"
}
},
"checks": {
"document": "PASS",
"identity": "PASS",
"document_tamper": "no_indication"
},
"completed_at": "2026-09-17T14:02:11Z"
}Entegrasyon notları
Sonucu nereden okursanız okuyun, aynı alanlar.
Yapılandırılmış alanlar, doğrulama oturumundan ayrı bir ürün değildir. Aynı sonucun parçası olarak gelirler.
- Alanlar, bir doğrulama tamamlandığında API üzerinden aldığınız oturum sonucunda iletilir.
- Doğrulama bittiğinde aynı sonuç imzalı bir webhook ile uç noktanıza iletilir; böylece sonucu sorgulamanız (polling) gerekmez.
- Her alan kaynağına atfedilir ve kendi kararını taşır; bu hem API sonucunda hem de webhook yükünde geçerlidir.
- Sandbox oturumları üretimle aynı alan yapısını döndürür; böylece tek bir gerçek belge okunmadan önce entegrasyonunuzu geliştirebilirsiniz.
Sorular
Veri çıkarma hakkında net yanıtlar.
Alanları kendiniz görün
Bir sandbox doğrulaması çalıştırın ve yapılandırılmış sonucu okuyun.
Bir sandbox oturumu oluşturun, kendi telefonunuzla bir belgeyi tarayın ve yanıtta her alanı, kaynağını ve kararını görün. Sandbox oturumları asla faturalandırılmaz.