مطابقة الوجه 1:1 عبر API: صورة السيلفي بمستند الهوية

​

إعادة المحاولة والملاحظات القابلة للتنفيذ

• رصيد المحاولات — يتحكم face_match_max_attempts في إجمالي عدد عمليات إرسال مطابقة الوجه لكل جلسة. القيمة الافتراضية هي 3 (محاولة أولية واحدة بالإضافة إلى محاولتي إعادة)، وهي قابلة للتهيئة لكل عقدة سير عمل (النطاق 1–3).
• ملاحظات إعادة المحاولة — طالما بقيت محاولات متاحة، فإن الفشل القابل لإعادة المحاولة يُبقي المستخدم في نفس الخطوة ويعيد feedback_codes (تعرض حزم SDK للويب وللهواتف المحمولة هذه الرموز كرسائل توجيهية تلقائياً):
  {
    "detail": "Make sure your face matches your document photo, improve lighting and try again.",
    "error": "LOW_FACE_MATCH_SIMILARITY",
    "feedback_codes": ["LOW_FACE_MATCH_SIMILARITY"],
    "attempts_used": 1,
    "max_attempts": 3
  }
  
• استنفاد المحاولات — بمجرد استنفاد الرصيد المتاح، يتم تطبيق الحالة المحسوبة (Declined أو In Review).

​

كيف يعمل

​

متطلبات المستند

​

المتطلبات العامة

• صادر عن جهة حكومية وصالح ضمن فترة الصلاحية المحددة له
• سليم مادياً (خالٍ من التلف أو الخدوش أو البقع التي قد تحجب التفاصيل)
• جميع المعلومات الأساسية (الاسم الكامل، تاريخ الميلاد، MRZ، وغيرها) مقروءة بوضوح
• اتساق البيانات عبر جميع المستندات المقدمة

​

متطلبات الصورة

• صورة أصلية ملتقطة في الوقت الفعلي (ليست لقطات شاشة أو نسخاً ممسوحة ضوئياً أو نسخاً رقمية)
• الصيغ المدعومة: JPG، JPEG، PNG، PDF
• الحجم الأقصى للملف: 5MB
• صورة ملونة بالكامل مع ظهور جميع زوايا المستند
• خالية من الوهج، أو الظلال، أو التعديل الرقمي، أو التلاعب
• يلزم تقديم مستندات مادية (لا تُدعم الهويات الرقمية إلا في مناطق محددة يُعترف بها فيها رسمياً)

​

إعدادات إضافية حسب الدولة ونوع المستند

• وضع انتهاء الصلاحية: اختر كيفية التعامل مع المستندات ذات تواريخ الانتهاء الماضية.
  • رفض المستندات المنتهية الصلاحية: إذا كان تاريخ انتهاء المستند يسبق اليوم، فسيتم تمييزه بأنه منتهي الصلاحية ورفضه.
  • السماح بالمستندات المنتهية الصلاحية: عدم تمييز أو حظر المستندات ذات تاريخ الانتهاء الماضي.
• تنسيق الأحرف المفضل: حدد كيفية تطبيع الأسماء والحقول المستخرجة.
  • تفضيل الأحرف اللاتينية (A–Z): مثال: “Mohammed”
  • تفضيل نظام الكتابة الأصلي (غير اللاتيني): مثال: “محمد”
• الدعم الإقليمي والأنواع الفرعية: قم بتمكين المستندات حسب المنطقة وحدد الأنواع الفرعية المقبولة عندما يحتوي نوع المستند على تنويعات متعددة.
  • مثال: بالنسبة لرخص القيادة في الولايات المتحدة، حدد الأنواع الفرعية الدقيقة التي تقبلها (على سبيل المثال، Arizona Commercial Driver License وIndiana Operator License (REAL ID) وNew York Enhanced Driver License وما إلى ذلك).
  • استخدم عنصر التحكم “الأنواع الفرعية المقبولة” لتضمين/استبعاد العديد من التنويعات بسرعة (على سبيل المثال، “تم تحديد 128”).

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