واجهة API للتعرّف الضوئي على جوازات السفر وبطاقات الهوية – استدعاء HTTP واحد، 1¢ للمستند
خدمة doc.cheap هي واجهة API للتعرّف الضوئي على الحروف (OCR) في جوازات السفر وبطاقات الهوية، تحوّل صورة وثيقة السفر إلى JSON منظّم بطلب HTTP واحد. أرسل صورة، واحصل على منطقة القراءة الآلية (MRZ) محلَّلة، وأرقام التحقق وفق ICAO 9303 مُتحقَّقًا منها، وحقول منطقة الفحص البصري مستخرجة – في الاستجابة نفسها، دون طابور تستعلم عنه ودون SDK تثبّته. يستغرق أول استدعاء ناجح أقل من 60 ثانية ولا يتطلب تسجيلًا: مفتاح sandbox عام موجود مسبقًا في المثال أدناه. يكلّف كل مستند يُتعرَّف عليه 1¢، بالسعر نفسه من مستندك الأول حتى مستندك رقم عشرة ملايين، والمسح الذي لا يجد شيئًا لا يكلّف شيئًا على الإطلاق.
- ✓ استدعاء متزامن واحد
- ✓ أول استدعاء خلال 60 ثانية
- ✓ لا تسجيل للبدء
- ✓ JSON مسطّح، دون تحليل
رسم متحرك تزييني: الكرة الأرضية، وقد رُسمت قاراتها بأحرف منطقة القراءة الآلية، تدور ثم تنبسط إلى خريطة مسطّحة. وتحتها تُكتب منطقة القراءة الآلية لجواز السفر النموذجي المستخدم في كل صفحات هذا الموقع.
جرّبه الآن – بلا حساب، بلا بطاقة، بلا فترة تجريبية
ارفع صورة مستند وسترى الحقول المُتعرَّف عليها على الشاشة. يعالج العرض صورتك أنت بمفتاح sandbox العام – تعرّف حقيقي، مجاني، بلا حساب – والطلب المعروض بجانبه هو الطلب نفسه، جاهز للّصق في الطرفية. وعندما تريده في شيفرتك، يأخذك دليل التعرّف الأول (بالإنجليزية) من هنا.
جرّبه الآن – بلا حساب
أفلِت صورة جواز سفر أو بطاقة هوية ويبدأ التعرّف فورًا. يُعاد تحجيمها في متصفحك وتُرسل إلى بيئة 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')\"}"تظهر نتيجة التعرّف أدناه لحظة اختيارك صورة – كل حقل، بكل لغة قُرئ بها، مع التحقق من منطقة القراءة الآلية رقمًا رقمًا.
ما الذي تحصل عليه: كل حقل، مع مطابقة متقاطعة
تحمل استجابة واحدة القراءة كلها. يُتحقق من منطقة القراءة الآلية رقمًا رقمًا وفق ICAO 9303 وتعود في صورة حكم واحد، ومعه الأسطر التي قُرئت منها؛ وكل حقل مطبوع على الصفحة يعود باسم ثابت، مرة لكل لغة قُرئ بها. ويذكر كل حقل درجة الثقة الخاصة به. يشرح دليل التعرّف على جواز سفر الاستدعاء كاملًا، ويسرد مستكشف الحقول كل مفتاح مع نوعه.
meta
ما هذا المسح وكيف جرى: معرّفه، وحالته، وهل استهلك وحدة رصيد، وفيمَ صُرف الوقت.
schema_version · id · status · billed · confidence · timing · created_at · reference
document
نوع المستند الذي تم التعرّف عليه، والدولة التي أصدرته، ورقمه وتواريخه، وهل انتهت صلاحيته. القيمة null عندما لا يُتعرَّف على شيء.
kind · country · country_name · issuing_state · type_name · type_confidence · number · series · issue_date · expiry_date · is_expired · days_remaining
holder
الشخص الذي يعرّف به المستند. القيمة null عندما لا يُتعرَّف على شيء.
given_names · surname · full_name · birth_date · sex · nationality
fields[]
كل حقل قُرئ من الصفحة المطبوعة، باسم ثابت. إدخال واحد لكل قراءة، لكلٍّ منها لغته ونطاق ثقته.
id · name · label · category · value · language · confidence
mrz
منطقة القراءة الآلية: حكم على سلامتها، والسبب حين لا تكون سليمة، والأسطر نفسها كما قُرئت تمامًا.
status · reason · lines · text
images
مقتطعات مأخوذة من الصورة التي أرسلتها، كلٌّ منها بصيغة data URL.
document_crop · rear · main_photo · signature · watermark_face · barcode · chip
quality
هل كانت الصورة التي أرسلتها جيدة بما يكفي للتعرّف عليها.
overall
authenticity
التحقق من الأصالة. لا يُنفَّذ في استدعاء التعرّف وحده، الذي يُبلغ عنه بأنه لم يُفحص.
overall · checks
منطقة نموذجية، وما يفعله المحلّل بها
حامل مُختلَق، وأرقام مُختلَقة، وأرقام تحقق محسوبة منها. الصقها في محلّل MRZ لترى كل رقم يُعاد حسابه في متصفحك، أو اقرأ كيف تختلف TD1 و TD2 و TD3.
P<GRCPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184GRC9403084F3203101PN48291630<<<<72الأسعار: 1¢ للمستند – وفقط عندما ينجح التعرّف
1¢ للمستند
السعر نفسه للجميع ومهما كان الحجم – المستند الأول والمستند رقم عشرة ملايين يكلّفان المبلغ نفسه.
لا تدفع إلا مقابل المستندات التي نتعرّف عليها فعلًا.
صورة ضبابية، لا مستند في الإطار، نوع غير معروف – مجانًا. لن تدفع أبدًا مقابل مسح فاشل.
- ✓ التعرّف مجانًا على 10 مستندات لكل عنوان بمفتاح sandbox العام، دون أي حساب على الإطلاق – بحد أقصى 10 طلبات في الساعة، أيًّا كانت الإجابة.
- ✓ عند التسجيل نضيف إلى رصيدك 20 مستندًا مجانًا.
كيف تُقارَن doc.cheap بغيرها
أسعار القوائم، كلٌّ منها مقروء من صفحة الأسعار الخاصة بالمزوّد نفسه ومرتبط بها. أما المزوّد الذي لا يمكن قراءة أسعاره من صفحاته العامة فيُستبعد بدلًا من تقديرها: رقم واحد لا يمكن التحقق منه يُفقد الجدول كله قيمته. وتضيف المقارنة الكاملة تكلفة المسح الفاشل، وأيّها يمكن استدعاؤه بلا حساب، وما يتفوّق فيه كلٌّ منها علينا.
| المزوّد | السعر المنشور | البدء مجانًا |
|---|---|---|
| doc.cheap | $0.01 للمستند، سعر ثابت مهما كان الحجم | بيئة sandbox عامة، بلا تسجيل |
| AWS Textract – Analyze ID | $0.025 للصفحة حتى 100,000 صفحة شهريًا؛ و $0.01 للصفحة بعد ذلك (us-west-2) المصدر | 100 صفحة شهريًا خلال الأشهر الثلاثة الأولى |
| Google Document AI | $0.10 للمستند (محلّل جوازات السفر الأمريكية)؛ $0.10 (رخصة القيادة) المصدر | – |
| Mindee | وحدات رصيد إضافية "starting from $0.05"، إضافةً إلى رسم تجاوز بنسبة 20 % المصدر | – |
| doc.cheap | $0 – المسح الذي لا يجد مستندًا لا تُحتسب عليه رسوم، وتذكر الاستجابة ذلك في المؤشر billed. |
|---|---|
| المزوّدون الثلاثة أعلاه | لا تنشر أيٌّ من صفحات أسعارهم استثناءً كهذا. |
نحن فعليًا لا نخزّن مستنداتك
تبقى الصورة المرفوعة في الذاكرة فقط، طوال مدة الطلب، ولا تُكتب على القرص أبدًا. ما يُحتفظ به هو النتيجة – الحصيلة والحقول المستخرجة، لا صورة للمستند أبدًا – للمدة التي تختارها: سنة، أو شهر، أو أسبوع، أو يوم، أو لا شيء على الإطلاق.
التعرّف على جوازات السفر لوكلاء الذكاء الاصطناعي: خادم MCP
الوكيل الذي يحتاج إلى قراءة جواز سفر لا يحتاج إلى عميل HTTP يُكتب له. توفّر doc.cheap خادم Model Context Protocol، فيستدعي المساعد التعرّف بوصفه أداة: يمرّر إليها صورة، ويحصل على الحقول المنظّمة نفسها. المفتاح نفسه، والسعر نفسه، وبنية الاستجابة نفسها كما في الـ API – لا شيء منها منتج منفصل.
أسئلة يطرحها المطوّرون
ما التعرّف الضوئي على الحروف (OCR) في جواز السفر؟
يقرأ التعرّف الضوئي على الحروف الأحرفَ المطبوعة من صورة فوتوغرافية للمستند ويحوّلها إلى نص. في جواز السفر شيئان يُقرآن: سطرا منطقة القراءة الآلية أسفل الصفحة، المطبوعان بخط مصمَّم لتقرأه الآلة، ومنطقة الفحص البصري فوقهما، وهي نص مطبوع عادي يختلف ترتيبه من جهة إصدار إلى أخرى.
ما منطقة MRZ؟
منطقة القراءة الآلية (MRZ) هي كتلة الأسطر ثابتة العرض أسفل جواز السفر أو بطاقة الهوية، ويحدد معيارها ICAO Doc 9303. وهي ترمّز رقم المستند، والدولة المُصدِرة، والاسم، والجنسية، وتاريخ الميلاد، والجنس، وتاريخ انتهاء الصلاحية، كلٌّ في موضع ثابت، مع أرقام تحقق تتأكد من صحة القراءة.
ما وثيقة ICAO Doc 9303؟
وثيقة ICAO Doc 9303، وعنوانها Machine Readable Travel Documents (وثائق السفر المقروءة آليًا)، هي المواصفة التي يتبعها كل جواز سفر وكل بطاقة هوية مقروءة آليًا. وهي منشورة في أجزاء: يتضمن الجزء 3 المواصفات المشتركة بين جميع وثائق السفر المقروءة آليًا، وتتضمن الأجزاء 4 و 5 و 6 جواز السفر TD3 والبطاقة TD1 والبطاقة TD2 على التوالي. وبفضلها يستطيع قارئ صُنع في أي مكان أن يقرأ جواز سفر صدر في أي مكان.
هل ترتكب واجهة API للتعرّف على جوازات السفر أخطاءً؟
أي قراءة لصورة فوتوغرافية قد تكون خاطئة، لذا صُمّمت الإجابة لتكون قابلة للتحقق لا لتُصدَّق دون فحص. يُتحقق من كل منطقة قراءة آلية بأرقام التحقق الخاصة بها وفق ICAO 9303 ويُدرج الحكم في الاستجابة؛ ويحمل كل حقل نطاق ثقة؛ وحين تختلف منطقة القراءة الآلية عن منطقة الفحص البصري تُعاد القراءتان معًا بدلًا من تفضيل إحداهما بصمت.
هل تخزّنون أيًّا من بياناتي؟
تبقى الصورة المرفوعة في الذاكرة طوال مدة الطلب ولا تُكتب على القرص أبدًا. ما يمكن الاحتفاظ به هو النتيجة – الحصيلة والحقول المستخرجة – لمدة تختارها للحساب أو لكل طلب، من سنة وحتى صفر، والصفر يعني ألا يُكتب شيء على الإطلاق.
هل تتوفر فترات تجريبية مجانية أو نسخ تجريبية؟
لا توجد فترة تجريبية تشترك فيها، لأنه لا يوجد ما يجب الاشتراك فيه أولًا. مفتاح sandbox عام منشور في التوثيق وفي المثال على هذه الصفحة، وهو يُجري عمليات تعرّف حقيقية. التسجيل يضيف مستندات مجانية إلى رصيد؛ وبعد ذلك تشحن الرصيد وتُخصم وحدة رصيد واحدة مقابل كل مستند يُتعرَّف عليه.
هل يمكن كشف المستندات المزوّرة أو المعدَّلة؟
لا، والاستجابة تقول ذلك بدلًا من السكوت عنه: قيمة حقل الأصالة هي not_checked. هذه الخدمة تُجري التعرّف، والتعرّف ليس مصادقة – لا شيء هنا يفحص عناصر الأمان في المستند. اجتياز أرقام التحقق يُثبت أن المنطقة متّسقة داخليًا، وهذا ما يُتقنه أيضًا كل من يصنع مستندًا مزيّفًا؛ أما ما تكشفه فهو التلف والوهج وأخطاء القراءة.
ما خادم MCP لمعالجة المستندات؟
بروتوكول Model Context Protocol هو المعيار الذي يصل به مساعد ذكاء اصطناعي إلى أداة. ويتيح خادم MCP لمعالجة المستندات التعرّفَ بوصفه أداة يستطيع المساعد استدعاءها، فيمرّر الوكيل صورة جواز سفر ويحصل على حقول منظّمة دون أن يكتب أحد شيفرة HTTP. توفّر doc.cheap خادمًا كهذا، وهو يستخدم المفتاح نفسه والسعر نفسه كما في الـ API.