ڈیٹا ایکسٹریکشن
ایک OCR شناختی کارڈ اسکیننگ API جو متن کے بلاک کے بجائے ساختہ فیلڈز واپس کرتی ہے۔
ShieldID سرکاری فوٹو شناختی کارڈ کو فیلڈ بہ فیلڈ ساختہ ڈیٹا میں بدل دیتا ہے: نام، تاریخِ پیدائش، دستاویز نمبر، میعادِ ختم، پتہ اور مزید، ہر فیلڈ اپنے ماخذ اور اپنے فیصلے کے ساتھ۔ ایک ہی سیشن میں دستاویزی ڈیٹا ایکسٹریکشن API اور دستاویزی تصدیق API۔
کیا واپس آتا ہے
ساختہ فیلڈز، جہاں دستاویز میں واقعی موجود ہوں۔
ہر دستاویز میں ہر فیلڈ نہیں ہوتی۔ ShieldID وہ واپس کرتا ہے جو دستاویز میں ہو، اور جو نہ ہو اس کی نشاندہی کر دیتا ہے۔
- پورا نام
- جیسا چھپا ہو، اور جیسا بار کوڈ یا MRZ میں انکوڈ ہو، جہاں دستاویز میں ان میں سے کوئی ہو۔
- تاریخ پیدائش
- چھپے ہوئے رخ سے پڑھا جاتا ہے اور بار کوڈ اور MRZ سے باہمی جانچ کی جاتی ہے۔
- دستاویز نمبر
- لائسنس نمبر یا پاسپورٹ نمبر، جس کی اندرونی مطابقت جاری کنندہ کا فارمیٹ اجازت دے تو جانچی جاتی ہے۔
- میعادِ ختم ہونے کی تاریخ
- چھپے ہوئے رخ اور بار کوڈ یا MRZ سے پڑھا جاتا ہے۔
- پتہ
- چھپے ہوئے رخ اور، جہاں موجود ہو، بار کوڈ سے پڑھا جاتا ہے؛ الگ سے اپ لوڈ کی گئی پتے کی دستاویز سے موازنہ کیا جا سکتا ہے۔
- جنس
- جہاں دستاویز اسے چھاپتی یا انکوڈ کرتی ہے وہاں سے پڑھا جاتا ہے۔
- جاری کرنے والا دائرہ اختیار
- بارکوڈ کے جاری کنندہ کوڈ سے شناخت کی جاتی ہے، جہاں دستاویز پر کوئی تسلیم شدہ کوڈ موجود ہو، جیسا دستیاب ہو۔
تین ذرائع، ایک موازنہ
بارکوڈ، MRZ اور چھپا ہوا اگلا رخ، سب جان بوجھ کر پڑھے جاتے ہیں، اتفاقاً آپس میں ملائے نہیں جاتے۔
ہر فیلڈ کی نسبت اس ماخذ سے ظاہر کی جاتی ہے جہاں سے وہ لی گئی۔ جب دو ذرائع میں اختلاف ہو تو نتیجے پر اس کی نشاندہی کی جاتی ہے، دونوں اعداد کی اوسط نہیں نکالی جاتی۔
PDF417 بارکوڈ
شمالی امریکا کے ڈرائیونگ لائسنس یا شناختی کارڈ کی پشت کو منظم AAMVA فیلڈز میں ڈیکوڈ کیا جاتا ہے۔ جب دستاویز پر بارکوڈ موجود ہو تو اس کے فیلڈز کو چھپے ہوئے اگلے رخ پر ترجیح حاصل ہوتی ہے۔
پاسپورٹ MRZ
مشین ریڈایبل زون کو تلاش کیا جاتا ہے، پڑھا جاتا ہے، اور زون میں شامل ICAO چیک ڈجٹ فارمولوں کے مطابق اس کی توثیق کی جاتی ہے۔ کم از کم درستگی کا اسکور، جس کے مقابل جانچ کی جاتی ہے، یہ طے کرتا ہے کہ MRZ سے پڑھی گئی فیلڈ پر بالکل بھروسا کیا جائے یا نہیں — جو زون اپنے ہی چیک سم میں ناکام ہو، وہ زیادہ صاف ماخذ کو رد نہیں کر سکتا۔
اگلے رخ کی منظم اور مکمل صفحے کی OCR
چھپا ہوا رخ دستاویز کے اپنے لے آؤٹ کی مدد سے پڑھا جاتا ہے جہاں وہ پہچانا جائے، ورنہ پورے صفحے کے OCR پر منتقل ہو جاتا ہے تاکہ کوئی غیر مانوس دستاویز بھی پڑھنے کے قابل فیلڈز فراہم کرے۔
تضادات کی نشاندہی کی جاتی ہے، ان کی اوسط نہیں نکالی جاتی
اگر اگلے رخ، بارکوڈ اور MRZ میں نام یا تاریخ پیدائش مختلف ہو تو نتیجے پر اسے عدم مطابقت کے طور پر رپورٹ کیا جاتا ہے۔ پائپ لائن میں کوئی چیز خاموشی سے کسی ایک کو فاتح نہیں چنتی اور اختلاف کو چھپاتی نہیں۔
MRZ چیک سم کی توثیق
مشین ریڈایبل زون پر بھروسا کرنے سے پہلے اسے اپنا حساب خود درست ثابت کرنا ہوتا ہے۔
پاسپورٹ پر موجود ICAO مشین ریڈایبل زون میں ڈیزائن کے لحاظ سے چیک ڈجٹس ہوتے ہیں۔ ShieldID MRZ سے پڑھی گئی فیلڈ کو قابل اعتماد ماننے سے پہلے انہیں جانچتا ہے۔
ایک مخصوص ڈیٹیکٹر MRZ کو تلاش کرتا ہے، ایک ریڈر حروف نکالتا ہے، اور زون کے اپنے چیک سم فارمولوں کے مطابق نتیجے کی درستگی کا اسکور نکالا جاتا ہے۔ صرف وہی فیلڈ مکمل ترجیح کے ساتھ قابل اعتماد مانی جاتی ہے جو کم از کم درستگی کا اسکور عبور کرے؛ جو زون خراب پڑھا جائے اس سے اسی کے مطابق برتاؤ کیا جاتا ہے، اسے صاف سمجھ کر آگے نہیں بڑھایا جاتا۔
بارکوڈ کو اولین ترجیح
جب ذرائع ایک دوسرے سے ملیں تو سب سے قابل اعتماد ماخذ کو فوقیت ملتی ہے۔
ایک ہی فیلڈ بارکوڈ پر، MRZ میں اور چھپے ہوئے اگلے رخ پر نظر آ سکتی ہے۔ ShieldID ہر بار ایک ہی مستقل ترتیب سے اس کا فیصلہ کرتا ہے۔
- PDF417 بارکوڈ
- پاسپورٹ MRZ، چیک سم عبور کرنے کے بعد
- چھپے ہوئے اگلے رخ کی منظم ریڈنگ
- مکمل صفحے کی OCR بطور متبادل
پتے کے دستاویزات
دوسری دستاویز اپ لوڈ کریں، پتے کا سیدھا سادہ موازنہ حاصل کریں۔
جب کسی تصدیق کے لیے پتے کا ثبوت درکار ہو تو درخواست گزار الگ دستاویز اپ لوڈ کرتا ہے اور ShieldID اسے اسی طرح پڑھتا ہے جیسے شناختی دستاویز کو۔
پتے کی دستاویز کو OCR سے گزارا جاتا ہے، اور اس کے پتے کا موازنہ شناختی دستاویز سے پڑھے گئے پتے سے کیا جاتا ہے۔ یہ سادہ متن اور ٹوکن کا موازنہ ہے، کوئی الگ دستاویز کلاسیفائر نہیں، اور یہ صرف اسی وقت چلتا ہے جب سیشن کو اس کی ضرورت ہو اور واقعی کوئی دستاویز فراہم کی گئی ہو۔
ریڈیکشن اور PII کا انتظام
نکالے گئے ڈیٹا کو اسی طرح محفوظ کیا جاتا ہے جیسے تصاویر کو۔
منظم فیلڈز انہی پرائیویسی کنٹرولز کے ساتھ رکھی جاتی ہیں جو خود شناختی تصاویر پر لاگو ہوتے ہیں۔
تاریخ پیدائش ذخیرہ کرتے وقت انکرپٹڈ
تاریخ پیدائش انکرپٹڈ حالت میں محفوظ کی جاتی ہے؛ انکرپشن کی کے بغیر سروس چلے گی ہی نہیں۔
تصاویر ٹائمر پر حذف
کھینچی گئی دستاویز اور سیلفی کی تصاویر ایک مختصر ٹائمر پر خودکار طور پر حذف ہو جاتی ہیں، بطور ڈیفالٹ سات دن بعد۔ ایک مقررہ وقفے سے اور ہر ری اسٹارٹ کے فوراً بعد بھی صفائی چلتی ہے، تاکہ خاموش دور میں بھی کوئی تصویر اپنے حذف ہونے کے دن سے آگے نہ رہے۔
ڈیوائس پر اسکور کی ریڈیکشن
جہاں کوئی مطابقت یا اعتماد کا عدد درخواست گزار کے اپنے فون پر دکھایا جاتا، وہاں ShieldID پیغام دکھائے جانے سے پہلے اس میں سے بنیادی فیصد ہٹا دیتا ہے، تاکہ خام اسکور آپ کے اکاؤنٹ سے باہر کبھی ظاہر نہ ہو۔
ریکارڈ تصاویر سے زیادہ عرصہ برقرار رہتا ہے
تصاویر ایک شیڈول پر حذف ہوتی ہیں۔ تصدیق ہونے کا حقیقت اور اس کے نتائج آپ کے اکاؤنٹ میں رہتے ہیں — اور Trust Ledger انٹیگریشن کے لیے Activity Ledger میں تصدیق شدہ/ناکام اندراج کے طور پر بھی (ShieldID API اکاؤنٹس کے لیے لیجر اندراجات: جلد آ رہا ہے)۔
نمونہ نتیجہ
ہر فیلڈ کے فیصلے، اسی شکل میں جس میں API واپس کرتا ہے۔
نیچے دیے گئے نام، نمبر اور پتے اس مثال کے لیے فرضی ہیں۔ فیلڈز کا سیٹ، ماخذ اور فیصلے نتیجے کی اصل شکل ہیں۔
| فیلڈ | قدر | ماخذ | فیصلہ |
|---|---|---|---|
| person.name | "Priya Chandrasekaran" | barcode | match |
| person.dob | "1991-07-22" | barcode | match |
| person.document_number | "C4839201" | mrz | match |
| person.document_country | "CA" | barcode issuer code | match |
| person.address | "18 Spruce Ave, Ottawa ON" | 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": "Priya Chandrasekaran",
"dob": "1991-07-22",
"document_type": "DRIVERS_LICENCE",
"document_country": "CA",
"document_jurisdiction": "ON",
"address": "18 Spruce Ave, Ottawa ON"
},
"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"
}انٹیگریشن نوٹس
وہی فیلڈز، چاہے آپ نتیجہ جہاں سے بھی پڑھیں۔
ساختہ فیلڈز تصدیقی سیشن سے الگ کوئی پروڈکٹ نہیں ہیں۔ یہ اسی نتیجے کا حصہ بن کر آتے ہیں۔
- تصدیق مکمل ہونے کے بعد فیلڈز اس سیشن نتیجے میں فراہم کیے جاتے ہیں جسے آپ API کے ذریعے حاصل کرتے ہیں۔
- تصدیق مکمل ہونے پر وہی نتیجہ ایک دستخط شدہ ویب ہک کے ذریعے آپ کے اینڈ پوائنٹ پر پہنچا دیا جاتا ہے، اس لیے آپ کو بار بار پوچھنے (poll) کی ضرورت نہیں۔
- ہر فیلڈ اپنے ماخذ سے منسوب ہوتی ہے اور اپنا الگ فیصلہ رکھتی ہے، API کے نتیجے میں بھی اور ویب ہک پے لوڈ میں بھی۔
- Sandbox سیشنز پروڈکشن جیسی ہی فیلڈ ساخت واپس کرتے ہیں، تاکہ آپ ایک بھی حقیقی دستاویز پڑھے جانے سے پہلے اپنا انٹیگریشن بنا سکیں۔
سوالات
ڈیٹا ایکسٹریکشن کے بارے میں سیدھے جوابات۔
فیلڈز خود دیکھیں
ایک sandbox تصدیق چلائیں اور ساختہ نتیجہ پڑھیں۔
ایک sandbox سیشن بنائیں، اپنے فون پر کوئی دستاویز اسکین کریں، اور جوابی نتیجے میں ہر فیلڈ، اس کا ماخذ اور اس کا فیصلہ دیکھیں۔ Sandbox سیشنز کا بل کبھی نہیں بنتا۔