أرسل صورة جواز سفر صادر عن المملكة العربية السعودية واحصل على بيانات منظّمة في استجابة HTTP نفسها – منطقة القراءة الآلية (MRZ) محلَّلة، وأرقام التحقق وفق ICAO 9303 مُتحقَّقًا منها، والحقول المرئية مستخرجة. لا SDK تثبّته، ولا طابور تستعلم عنه.
يتبع جواز السفر الصادر عن المملكة العربية السعودية معيار ICAO 9303: منطقة قراءة آلية من سطرين في كلٍّ منهما 44 حرفًا (الصيغة TD3) مطبوعة أسفل صفحة البيانات، فوق منطقة الفحص البصري التي يقرؤها الإنسان. أحرفها الخمسة الأولى هي P<SAU – رمز المستند، ثم الدولة المُصدِرة برمز ISO 3166-1 alpha-3 SAU. تقرأ الـ API المنطقتين، وتطابق أرقام التحقق في MRZ، وتعيد بنية استجابة واحدة تحضر فيها كل المفاتيح.
رمز المملكة العربية السعودية هو SA في قائمة alpha-2 و SAU في المنطقة: هنا الرمز الأطول هو الأقصر مضافًا إليه U. يصحّ هذا في هذا الزوج وليس قاعدةً عامة، لذا فإن اشتقاق أحدهما من الآخر خطأ برمجي ينتظر أول بلد لا ينطبق عليه.
يعرّف المعيار 9303 ثلاثة تخطيطات للمنطقة، وتقرأ الـ API الثلاثة جميعًا. في الأسفل حاملة مُختلَقة واحدة – ليست أحدًا، و paradeigma هي الكلمة اليونانية التي تعني مثال – في كل تخطيط، مع SAU بوصفها الدولة المُصدِرة. كل رقم تحقق محسوب من الأحرف المجاورة له لا مكتوب يدويًا، لذا فكل منطقة هنا صالحة.
سطران، في كل سطر 44 حرفًا. الجنسية SAU. الدولة المُصدِرة والجنسية كلتاهما SAU: جواز السفر يشهد بجنسية الدولة التي أصدرته.
P<SAUPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184SAU9403084F3203101PN48291630<<<<72سطران، في كل سطر 36 حرفًا. الجنسية GRC. صادرة عن SAU لشخص يحمل جنسية GRC، لذا يختلف الرمزان. يتألف الاسم هنا من 31 حرفًا بدلًا من 39 في جواز السفر.
I<SAUPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<23 أسطر، في كل سطر 30 حرفًا. الجنسية GRC. ثلاثة أسطر في كلٍّ منها 30 حرفًا، والاسم في سطر مستقل. رمز المستند هو ID – يحدد الجزء 5 من 9303 الحرف الأول بأنه A أو C أو I ويترك الثاني للدولة المُصدِرة.
IDSAUAK472913<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¢ للمستند، ولا تُخزَّن صورة المستند أبدًا.
لا تدفع إلا مقابل المستندات التي نتعرّف عليها فعلًا.
صورة ضبابية، لا مستند في الإطار، نوع غير معروف – مجانًا. لن تدفع أبدًا مقابل مسح فاشل.