يقدّم جواز السفر للمحلِّل هدية: منطقة القراءة الآلية (MRZ). كتلة من الأحرف الكبيرة والأرقام وأحرف الحشو < تمتد أسفل صفحة البيانات، ومعها أرقام تحقق محسوبة من حقولها. اقرأ المنطقة، وأعد حساب الأرقام، فتعرف هل القراءة متماسكة قبل أن تثق بأي حقل.

أما رخصة القيادة فلا تعطيك عادةً شيئًا من ذلك. فمعظم الجهات المُصدِرة لا تطبع منطقة قراءة آلية على الرخصة أصلًا، فلا يبقى ما يُعاد حسابه. والمطورون الذين بنوا أول مسار معالجة لديهم على جوازات السفر يكتشفون ذلك غالبًا بالطريقة الصعبة، حين يصطدم الجزء من الشيفرة الذي "يتحقق من MRZ" ببطاقة بلا منطقة، فيبدأ في معاملة رخصة سليمة تمامًا على أنها خطأ.

هذا المقال عن تلك الحالة: ما الذي تحمله الرخصة بدلًا من المنطقة، وما الذي يستطيع API للتعرّف أن يخبرك به عنها وما لا يستطيع، وكيف تتحقق من الحقول بنفسك حين لا توجد أرقام تحقق تعتمد عليها. النصوص الأصلية للاقتباسات من AAMVA والاتحاد الأوروبي بالإنجليزية، والترجمات من عندنا.

هذه مدونة doc.cheap، وهي واجهة API للتعرّف على جوازات السفر وبطاقات الهوية. اقرأ الجزء المتعلق بالمنتج وأنت تضع ذلك في اعتبارك.

ما الذي تحمله الرخصة بدلًا من ذلك

لا يوجد تنسيق واحد لرخص القيادة. كل جهة مُصدِرة تصمّم بطاقتها، والمعايير الموجودة تحدد ما ينبغي أن تحتويه البطاقة وكيف تُرتَّب، لا سلسلة ثابتة واحدة تُحلَّل.

أمريكا الشمالية: باركود على الظهر. تنشر الجمعية الأمريكية لمسؤولي المركبات الآلية (AAMVA) معيار تصميم بطاقات DL/ID للبطاقات التي يصدرها أعضاؤها. ويتضمن إصدار 2026 ملحقًا بعنوان "باركود PDF417 الإلزامي" جاء فيه: "رمزية الباركود ثنائي الأبعاد PDF417 هي الحد الأدنى من تقنيات القراءة الآلية الإلزامية التي يجب أن تكون موجودة في وثائق DL/ID المطابقة." ويضيف الملحق نفسه: "يجب أن تكون جميع البيانات الإلزامية والاختيارية غير مشفّرة." إذن تحمل البطاقة المطابقة بيانات صاحبها مرتين – مطبوعة على الوجه، ومُرمَّزة في باركود ثنائي الأبعاد يستطيع قراءته أي شخص لديه أداة فك ترميز.

الاتحاد الأوروبي: نموذج بطاقة موحّد يُقرأ من وجهها. تصف صفحة Your Europe عن استبدال رخص القيادة والاعتراف بها الرخصة الحالية بأنها "التنسيق الأوروبي الموحّد الجديد (بطاقة بلاستيكية بصورة بحجم بطاقة الائتمان)". التخطيط مشترك، لكن ما تقرؤه منه هو النص المطبوع. وما زالت الرخص الورقية الأقدم متداولة أيضًا: تقول الصفحة نفسها "إذا كانت لديك رخصة أوروبية من الطراز القديم، فلا يزال بإمكانك استخدامها في جميع دول الاتحاد الأوروبي"، وإن مثل هذه الرخصة يجب استبدالها "بحلول عام 2033 على أبعد تقدير".

الطبقة الدولية. تذكر صفحة AAMVA نفسها أن العمل على معيار دولي لرخص القيادة يجري في ISO، وأن "المعيار الدولي (18013) يضع إرشادات لتنسيق رخص قيادة المركبات الآلية (DL) ومحتواها". وتعدّد الصفحة التقنيات التي يتناولها المعيار، ومنها "الباركود، أحادي الأبعاد وثنائي الأبعاد" و"التعرّف الضوئي على الحروف". بعبارة أخرى، يترك المعيار الخيار للجهة المُصدِرة؛ ولا يمنحك منطقة فيها أرقام تحقق.

النتيجة العملية بالنسبة إلى المحلِّل:

جواز السفر رخصة القيادة
منطقة القراءة الآلية دائمًا، في صفحة البيانات غالبًا لا توجد
أرقام تحقق يمكنك إعادة حسابها نعم، من المنطقة لا شيء، حين لا توجد منطقة
نسخة ثانية من البيانات المنطقة باركود، إن طبعته الجهة المُصدِرة (عادةً على الظهر)
تاريخ الانتهاء مطبوع في صفحة البيانات مطبوع إن كان للرخصة تاريخ انتهاء؛ بعضها صالح مدى الحياة
ما يخبرك بأن القراءة متسقة المنطقة مقارنةً بالصفحة المطبوعة فحوصك أنت على الحقول المطبوعة

لماذا لا يجوز أن يعني "لا منطقة" أن الوثيقة "غير صالحة"

إن بدأ مسار المعالجة لديك بجوازات السفر، فالأرجح أنه يتفرّع بحسب المنطقة: نجحت، تابِع؛ فشلت، اطلب صورة جديدة. والرخصة تضيف جوابًا ثالثًا، وهو الأكثر شيوعًا.

يعرض doc.cheap المنطقة في حكم واحد، mrz.status، بثلاث قيم. passed تعني أن المنطقة موجودة وأن كل أرقام التحقق صحيحة. failed تعني أن منطقة قُرئت وأن شيئًا فيها لم يتطابق. absent تعني أن الوثيقة لا تحمل منطقة – وعندها تكون reason وlines وtext كلها null. ويقولها دليل رخصة القيادة صراحةً: "تعامل مع absent على أنها نتيجة عادية، لا على أنها خطأ."

بقية الوثيقة لا تتأثر. تُتعرَّف الرخصة من وجهها المطبوع مثل أي وثيقة أخرى، وتعود meta.status بالقيمة recognized. لذا فالتفرّع الذي تحتاج إليه ليس "المنطقة نجحت أو ارفض"، بل:

  • failed – شيء في المنطقة لم يتطابق؛ اطلب صورة أفضل.
  • passed – اجتازت المنطقة التحقق؛ تابِع.
  • absent – لم يكن هناك ما يُتحقَّق منه؛ انتقل إلى فحوص الحقول الخاصة بك أدناه.

قراءة رخصة بطلب API واحد

تُرسَل الرخصة إلى نقطة النهاية نفسها التي يُرسَل إليها جواز السفر، وبالمحتوى نفسه: طلب POST /v1/scans واحد تكون فيه الصورة مرمَّزة بـ base64 داخل JSON. ويعمل مفتاح sandbox العام sk_sandbox_public دون حساب. استخدم معه صورة اختبار، ولا تستخدم رخصة حقيقية أبدًا: كل عملية مسح بالمفتاح العام تُحفظ سنة كاملة في سجل الخدمة نفسها.

curl -X POST https://api.doc.cheap/v1/scans \
  -H "Authorization: Bearer sk_sandbox_public" \
  -H "Content-Type: application/json" \
  -d "{\"image\": \"$(base64 < licence-front.jpg | tr -d '\n')\"}"

تبدو أجزاء الإجابة المهمة بالنسبة إلى الرخصة على هذا النحو. كل القيم مختلَقة، والدولة المُصدِرة هي UTO، الدولة الخيالية التي تستخدمها الوثائق النموذجية:

{
  "meta": { "status": "recognized", "billed": true, "confidence": "high" },
  "document": {
    "country": "UTO",
    "number": "DL0000000",
    "issue_date": "2024-05-02",
    "expiry_date": "2034-05-01",
    "is_expired": false,
    "days_remaining": 2725
  },
  "holder": {
    "surname": "SPECIMEN",
    "given_names": "ALEX JORDAN",
    "birth_date": "1990-01-01"
  },
  "fields": [
    { "id": "dl_class@0", "name": "dl_class", "label": "Driving-licence class",
      "category": "document", "value": "B, BE", "language": "English", "confidence": "high" },
    { "id": "authority@0", "name": "authority", "label": "Issuing authority",
      "category": "document", "value": "UTOPIA LICENSING OFFICE", "language": "English", "confidence": "medium" }
  ],
  "mrz": { "status": "absent", "reason": null, "lines": null, "text": null },
  "authenticity": { "overall": "not_checked", "checks": [] }
}

ما ينبغي قراءته منها:

  • fields هي موضع البيانات الخاصة بالرخصة. يسرد فهرس الحقول ما تحمله الرخصة عادةً: surname وgiven_names وbirth_date وdocument_number وdl_class أو permit_class وissue_date وexpiry_date وaddress وauthority. وتُنشَر أجزاء العنوان (address_street وaddress_city وaddress_state وaddress_postal_code) منفصلةً إلى جانب العنوان كاملًا. والمجموعة مفتوحة، فالحقل الذي لا تسمّيه المفردات يُنشَر مع ذلك تحت الفئة other.
  • استخدم id مفتاحًا، لا name. الرخصة المطبوعة بنظامَي كتابة تعيد مدخلًا لكل لغة تحت name نفسه؛ وid وحده فريد.
  • document.expiry_date و**is_expired** و**days_remaining** تُحسَب من تاريخ الانتهاء المطبوع، بدءًا من يوم المسح.

ما الذي يضيفه الباركود، وما الذي يفعله الـ API به

لا يحصل الباركود المفكوك على مجموعة خاصة به في الاستجابة. تصل قيمه في fields إلى جانب كل شيء آخر، وتحمل images.barcode صورة مقتطعة له حين يُقتطع.

ثمة عقبة عملية واحدة. تقرأ نقطة النهاية صورة واحدة في كل طلب، والجهة التي تطبع باركودًا تضعه عادةً على ظهر البطاقة. فإذا احتجت إلى ما يحمله الباركود، فأرسل الظهر في عملية مسح مستقلة وادمج النتيجتين بنفسك. وهذا الدمج هو أيضًا أفضل بديل لديك عن أرقام التحقق: قراءتان مستقلتان للبطاقة نفسها يُفترض أن تتطابقا.

التحقق من رخصة دون أرقام تحقق

بلا منطقة، يصبح الاتساق مسؤوليتك. لا يثبت أيٌّ من هذه الفحوص أن الرخصة أصلية؛ لكنها تلتقط أخطاء القراءة والمدخلات الخاطئة بوضوح قبل أن تصل إلى قاعدة بياناتك.

  1. التواريخ بترتيبها. birth_date قبل issue_date، وissue_date في يوم المسح أو قبله، وexpiry_date بعد issue_date. القراءة التي تكسر هذا الترتيب خطأ قراءة أو صورة رديئة.
  2. تاريخ الانتهاء من الوثيقة، لا من قاعدة. تختلف مدد الصلاحية من جهة إلى أخرى – ومثال صفحة الاتحاد الأوروبي نفسها رخصة من قبرص "صالحة 15 عامًا، بدلًا من 10 أعوام كما في إيطاليا". اقرأ التاريخ من البطاقة؛ لا تحسبه.
  3. خطّط لحالة غياب تاريخ الانتهاء. تذكر صفحة الاتحاد الأوروبي نفسها "رخص القيادة الأوروبية الصالحة مدى الحياة". وحين لا يُقرأ تاريخ انتهاء، تكون expiry_date وis_expired وdays_remaining كلها null معًا، ويكون الحقل المشتق days_to_expire أيضًا null. قرّر ما يفعله مسارك عندئذٍ؛ ولا تعامل null عن غير قصد على أنها منتهية أو صالحة.
  4. الفئة، لا مجرد الوجود. إن كنت تحتاج إلى شخص مرخَّص لقيادة سيارة، فابحث عن تلك الفئة في dl_class أو permit_class بدلًا من التحقق من وجود رخصة فحسب. القيمة نص مطبوع مثل B, BE، فقسّمها قبل المطابقة، وطابقها مع الفئات التي تحددها جهتك القانونية.
  5. الوجه مقابل الظهر. حين تحمل البطاقة باركودًا، امسح الوجهين وقارن الاسم وتاريخ الميلاد ورقم الوثيقة. وإن لم تتطابق، فاطلب صورة ثانية.
  6. مقابل ما كتبه المستخدم. قارن holder.surname وholder.birth_date بالنموذج الذي ملأه مستخدمك، بعد توحيدهما بالطريقة نفسها.
  7. مستوى الثقة إشارةً. تحمل كل قراءة مستوى – high أو medium أو low. ومستوى low في حقل تعتمد عليه سبب وجيه لطلب صورة جديدة.

كم يكلّف المسح حين لا توجد منطقة

على مفتاح فعلي، يستهلك المسح رصيدًا واحدًا حين يُحدَّد نوع الوثيقة ويتحقق واحد من ثلاثة أمور: قُرئت منطقة واجتازت أرقام التحقق فيها، أو قُرئت خمسة حقول أو أكثر من المنطقة المرئية، أو فُكّ ترميز باركود. لذلك تُحتسَب الرخصة بموجب الأمر الثاني أو الثالث. والصورة الرديئة إلى حدٍّ لا تُخرج معه خمسة حقول ولا باركودًا مجانية. وتتضمن قاعدة الاحتساب التعريف الكامل.

ما لا يخبرك به التعرّف الضوئي

قراءة الرخصة والتحقق منها عملان مختلفان. يقرأ doc.cheap ما هو مطبوع على البطاقة، وعلى ظهرها الباركود. وفي سيناريو التعرّف فقط تكون authenticity.overall بالقيمة not_checked، فهو لا يخبرك هل البطاقة أصلية، ولا هل هي موقوفة، ولا هل الشخص الذي يحملها هو صاحبها. وإن احتاج مسارك إلى أيٍّ من ذلك، فتلك خطوات منفصلة بأدوات وسجلات مصمّمة لها.

جرّبه

مفتاح sandbox العام لا يحتاج إلى حساب. وبالتسجيل تحصل على 100 عملية تعرّف مجانية كل شهر على مفتاحك الخاص، وهذا يكفي لبناء المسار كله – الوجه والظهر وفحوصك الخاصة. وإن كنت تختار مزوّدًا، فإن مقارنة واجهات API للتعرّف الضوئي على جوازات السفر تضع الأسعار المنشورة جنبًا إلى جنب، ودليل رخصة القيادة يعرض الطلب بـ curl وJavaScript وPython مع نصائح لتصوير بطاقة لامعة.

سؤال لك: حين لا تحمل الرخصة منطقة، أي فحص يلتقط أكبر عدد من القراءات الرديئة في مسارك – التواريخ، أم الباركود على الظهر، أم شيء آخر؟ أخبرنا في التعليقات أدناه.