أرسل صورة جواز سفر صادر عن الإمارات العربية المتحدة واحصل على بيانات منظّمة في استجابة HTTP نفسها – منطقة القراءة الآلية (MRZ) محلَّلة، وأرقام التحقق وفق ICAO 9303 مُتحقَّقًا منها، والحقول المرئية مستخرجة. لا SDK تثبّته، ولا طابور تستعلم عنه.
يتبع جواز السفر الصادر عن الإمارات العربية المتحدة معيار ICAO 9303: منطقة قراءة آلية من سطرين في كلٍّ منهما 44 حرفًا (الصيغة TD3) مطبوعة أسفل صفحة البيانات، فوق منطقة الفحص البصري التي يقرؤها الإنسان. أحرفها الخمسة الأولى هي P<ARE – رمز المستند، ثم الدولة المُصدِرة برمز ISO 3166-1 alpha-3 ARE. تقرأ الـ API المنطقتين، وتطابق أرقام التحقق في MRZ، وتعيد بنية استجابة واحدة تحضر فيها كل المفاتيح.
رمز الإمارات العربية المتحدة هو AE في قائمة alpha-2 و ARE في المنطقة، ولا توصلك أي إضافة من أحدهما إلى الآخر – فالرمز AE ليس حتى بادئةً للرمز ARE. والنظام الذي يخزّن الرمز المكوّن من حرفين يحتاج إلى جدول ISO 3166-1 للوصول إلى الرمز المكوّن من ثلاثة أحرف الذي تطبعه منطقة القراءة الآلية فعلًا.
يعرّف المعيار 9303 ثلاثة تخطيطات للمنطقة، وتقرأ الـ API الثلاثة جميعًا. في الأسفل حاملة مُختلَقة واحدة – ليست أحدًا، و paradeigma هي الكلمة اليونانية التي تعني مثال – في كل تخطيط، مع ARE بوصفها الدولة المُصدِرة. كل رقم تحقق محسوب من الأحرف المجاورة له لا مكتوب يدويًا، لذا فكل منطقة هنا صالحة.
سطران، في كل سطر 44 حرفًا. الجنسية ARE. الدولة المُصدِرة والجنسية كلتاهما ARE: جواز السفر يشهد بجنسية الدولة التي أصدرته.
P<AREPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184ARE9403084F3203101PN48291630<<<<72سطران، في كل سطر 36 حرفًا. الجنسية GRC. صادرة عن ARE لشخص يحمل جنسية GRC، لذا يختلف الرمزان. يتألف الاسم هنا من 31 حرفًا بدلًا من 39 في جواز السفر.
I<AREPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<23 أسطر، في كل سطر 30 حرفًا. الجنسية GRC. ثلاثة أسطر في كلٍّ منها 30 حرفًا، والاسم في سطر مستقل. رمز المستند هو ID – يحدد الجزء 5 من 9303 الحرف الأول بأنه A أو C أو I ويترك الثاني للدولة المُصدِرة.
IDAREAK472913<4PN48291630<<<<<
9403084F3405204GRC<<<<<<<<<<<9
PARADEIGMA<<ELENI<SOFIA<<<<<<<لا يغطي أي رقم تحقق الدولةَ المُصدِرة: في التخطيطات الثلاثة يجري الحساب على رقم المستند، والتواريخ، والبيانات الاختيارية، ولا يجري أبدًا على الأحرف الثلاثة التي تذكر من أصدر المستند. المنطقة التي تجتاز كل أرقامها الفحص لم تُثبت أنها صادرة عن الإمارات العربية المتحدة – فذلك تُثبته المنطقة المرئية وعناصر الأمان في المستند نفسه.
الصق MRZ في محلّل MRZ للتحقق من أرقام التحقق فيها، أو أنشئ واحدة باستخدام مولّد MRZ.
كل جواز سفر صادر عن الإمارات العربية المتحدة يُتعرَّف عليه يعيد الحقول المنظّمة نفسها. القيمة التي تعذّرت قراءتها تكون null، ولا يغيب المفتاح أبدًا.
اطّلع على كل الحقول في مستكشف حقول المستند (بالإنجليزية).
شغّل هذا على بيئة sandbox العامة – بلا تسجيل، وتعرّف حقيقي، ومجانًا لعدد محدود من المستندات وبحد أقصى 10 طلبات في الساعة لكل IP. ضع مفتاحك الحي الخاص مكان مفتاح sandbox لتواصل التعرّف على جوازات السفر الصادرة عن الإمارات العربية المتحدة.
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')\"}"تغطي هذه الصفحة ما يخص الإمارات العربية المتحدة تحديدًا. أما الصفحات الأربع أدناه (بالإنجليزية) فتتضمن كل ما عدا ذلك.
الاستدعاء أعلاه مع مستند حقيقي، بـ curl و JavaScript و Python، مع شرح كل مفتاح في الإجابة.
لماذا يطبع المستند المعلومات نفسها مرتين، وأي منطقة تُصدَّق حين تختلفان، وما الذي تستطيع أرقام التحقق أعلاه إثباته وما لا تستطيع.
المنطقة نقحرة لاتينية؛ والمنطقة المرئية ليست كذلك. أي قراءة تحمل الخط الأصلي، وكيف يُحَلّ معرّف اللغة إلى لغة.
كل رمز خطأ يمكن أن تجيب به الـ API، في جدول واحد: ما سببه، وهل يمكن أن تنجح إعادة المحاولة، وهل احتُسبت رسوم الاستدعاء.
أول استدعاء ناجح في أقل من 60 ثانية، و 1¢ للمستند، ولا تُخزَّن صورة المستند أبدًا.
لا تدفع إلا مقابل المستندات التي نتعرّف عليها فعلًا.
صورة ضبابية، لا مستند في الإطار، نوع غير معروف – مجانًا. لن تدفع أبدًا مقابل مسح فاشل.