التعرّف الضوئي على جواز السفر البريطاني: التخطيط ومنطقة MRZ وطلب API واحد

جواز السفر البريطاني من أكثر الوثائق التي يراها أي مسار تسجيل عملاء في المملكة المتحدة. ومكتب الجوازات البريطاني (HM Passport Office)، الذي يصف نفسه بأنه "الجهة الوحيدة المُصدِرة لجوازات السفر البريطانية"، مسؤول بكلماته "عن إصدار أكثر من 6 ملايين جواز سفر كل عام للمواطنين البريطانيين وغيرهم من الرعايا البريطانيين". فإن كان منتجك يتحقق من العملاء في المملكة المتحدة، فستقرأ كثيرًا منها.

هذا المقال موجّه للمطورين الذين يحتاجون إلى استخراج البيانات من جواز السفر البريطاني وإدخالها إلى أنظمتهم. يتناول ما على صفحة البيانات، وكيف تُرتَّب منطقة القراءة الآلية (MRZ)، وأي التصاميم ستصادفها في 2026، وما الذي يعيده طلب API واحد. كل ما يُقال عن جواز السفر نفسه مقتبس من GOV.UK أو ICAO، مع رابط في موضعه؛ النصوص الأصلية للاقتباسات بالإنجليزية، والترجمات من عندنا.

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

صفحة البيانات في صورة واحدة

تصف إرشادات معلومات جوازات السفر التاريخية الصادرة عن مكتب الجوازات البريطاني الدفتر الحالي: "في 1 مارس 2020، أُدخل جواز السفر الإلكتروني البريطاني من السلسلة C (جواز السفر الإلكتروني الأزرق) إلى الإنتاج تدريجيًا." ووفقًا للصفحة نفسها، فإن جواز السفر:

• "له صفحة بيانات شخصية من البولي كربونات المتين في مقدمة الدفتر"
• "تُطبع الملاحظات فيه على الصفحة 3"
• "تظهر فيه صورة جواز السفر الخاصة بالعميل 3 مرات داخل الدفتر"
• "فيه الشريحة الإلكترونية، مدمجة في صفحة البيانات الشخصية"

بالنسبة إلى OCR (التعرّف الضوئي على الحروف) يعني هذا شيئًا واحدًا: كل ما تحتاج إليه موجود في صفحة واحدة في المقدمة. صوّر تلك الصفحة مسطّحة وكاملة، فتحصل على الحقول المطبوعة والصورة الشخصية ومنطقة القراءة الآلية في صورة واحدة. الشريحة داخل الصفحة نفسها، لكن الصورة لا تستطيع قراءة شريحة؛ فما تعطيك إياه الصورة هو الصفحة المطبوعة.

منطقة القراءة الآلية

منطقة MRZ هي كتلة الأحرف الكبيرة والأرقام وأحرف الحشو < الممتدة أسفل صفحة البيانات. وتشرح الإرشادات نفسها مصدرها: "تُحوَّل البيانات الشخصية للعميل إلى أحرف تقرؤها أجهزة مسح جوازات السفر. وتُضاف الأحرف إلى جواز السفر في سطرين من 44 حرفًا لكل منهما. وتُعرف هذه المعلومات باسم منطقة القراءة الآلية."

سطران من 44 حرفًا هما تنسيق جواز السفر في وثيقة ICAO رقم 9303. وتسمّي صفحة ICAO الخاصة بالوثيقة 9303 الجزء 4 منها "مواصفات جوازات السفر المقروءة آليًا (MRPs) ووثائق السفر المقروءة آليًا الأخرى بحجم TD3"، ولهذا يُسمّى تخطيط جواز السفر TD3. ويغطي الجزءان 5 و6 الحجمين الأصغر TD1 وTD2، وهما ما تستخدمه بطاقات الهوية.

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

نقطتان عمليتان لمن يكتب المحلل (parser):

• لا يوجد تاريخ إصدار. المنطقة لا تحمله. إن احتجت إليه، فيجب أن يأتي من الصفحة المطبوعة.
• الجنسية ليست دائمًا GBR. رموز الدول في المنطقة تتبع وثيقة ICAO رقم 9303، لا معيار ISO، ولفئات الجنسية البريطانية رموز خاصة بها. ويسرد مرجع الاستجابة لدى doc.cheap خمسة رموز إلى جانب GBR – GBD وGBN وGBO وGBP وGBS – فالمحلل الذي لا يقبل إلا GBR سيرفض بعض جوازات السفر البريطانية.

التصاميم التي ستصادفها

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

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

وللصلاحية فخ أيضًا. قبل أكتوبر 2018 كان التجديد يمكن أن ينقل المدة المتبقية من الدفتر القديم: إذ تضرب الإرشادات مثلًا ببالغ جدّد جوازه وقد بقيت فيه 7 أشهر فحصل على جواز سفر "صالح لمدة 10 سنوات و7 أشهر". ومنذ أكتوبر 2018 تحصل التجديدات على "ما لا يزيد على: صلاحية 10 سنوات (للبالغين)، وصلاحية 5 سنوات (للأطفال)". لذا اقرأ تاريخ الانتهاء من الوثيقة؛ ولا تحسبه من تاريخ الإصدار.

قراءة جواز بطلب API واحد

يقرأ doc.cheap جواز السفر من صورة واحدة: طلب POST /v1/scans واحد، والصورة مرمّزة بـ base64 داخل جسم JSON. ويعمل مفتاح بيئة الاختبار العام sk_sandbox_public دون حساب. استخدم معه صورة نموذجية (specimen)، ولا تستخدم جواز سفر حقيقيًا أبدًا، لأن عمليات المسح التي تتم بالمفتاح العام تُحفظ لمدة عام.

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')\",
       \"options\": {\"expect_country\": \"GBR\", \"return_portrait\": false}}"

يمرّر expect_country الجهة المُصدِرة كتلميح عندما تعرفها مسبقًا، ويُبقي return_portrait: false وجه الحامل خارج الاستجابة. وتبدو أجزاء الجواب المهمة لجواز سفر بريطاني هكذا، بقيم مختلَقة:

{
  "document": {
    "kind": "passport",
    "issuing_state": "GBR",
    "issuing_state_detail": { "code": "GBR", "alpha3": "GBR", "alpha2": "GB", "category": "iso" },
    "number": "000000000",
    "issue_date": "2025-12-01",
    "expiry_date": "2035-12-01",
    "is_expired": false
  },
  "holder": {
    "surname": "SPECIMEN",
    "given_names": "ANGELA ZOE",
    "birth_date": "1990-01-01",
    "nationality": "GBR"
  },
  "mrz": { "status": "passed", "reason": null },
  "authenticity": { "overall": "not_checked", "checks": [] }
}

ما الذي تقرؤه منه:

• mrz.status قيمته passed أو failed أو absent. وتعني passed أن كل أرقام التحقق صحيحة وأن لا شيء في المنطقة يناقض الصفحة المطبوعة. وعند failed يسمّي mrz.reason الحقل، فتعرف هل تطلب صورة جديدة. ويحمل mrz.text المنطقة كسلسلة واحدة إن أردت إعادة حساب الأرقام بنفسك؛ ويشرح ذلك خطوة بخطوة دليل فحص MRZ.
• document.issue_date يأتي من الصفحة المطبوعة، لأن المنطقة لا تحمله.
• holder.nationality_detail يُبقي GBD وبقية الرموز البريطانية كما كُتبت، مع ضبط category على british_nationality وalpha3 على GBR، فيمكنك الاعتماد على الدولة دون فقدان الفئة.

وتجمع صفحة التعرّف الضوئي على جواز السفر البريطاني الحقائق نفسها في مكان واحد، مع الروابط إلى GOV.UK وICAO.

ما لا يخبرك به OCR

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

جرّبه

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

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