استخراج البيانات
واجهة API لمسح الهويات عبر OCR تعيد حقولًا مهيكلة، لا كتلة نصية.
يحوّل 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 بعد اكتمال عملية التحقق.
- تُسلَّم النتيجة نفسها إلى نقطة النهاية لديك عبر webhook موقَّع عند انتهاء التحقق، فلا حاجة إلى الاستعلام الدوري عنها.
- يُنسب كل حقل إلى مصدره ويحمل نتيجته الخاصة، في نتيجة API وفي حمولة webhook على حد سواء.
- تعيد جلسات sandbox شكل الحقول نفسه المعتمد في الإنتاج، فيمكنك بناء تكاملك قبل قراءة أي وثيقة حقيقية.
أسئلة
إجابات مباشرة عن استخراج البيانات.
شاهد الحقول بنفسك
أجرِ عملية تحقق في sandbox واقرأ النتيجة المهيكلة.
أنشئ جلسة sandbox، وامسح وثيقة بهاتفك، وشاهد في الاستجابة كل حقل ومصدره ونتيجته. جلسات sandbox لا تُفوتر أبدًا.