تحذيرات البحث بالوجه 1:N وأكواد الأخطاء

​

نظرة عامة

​

التحذيرات الصادرة

• قائمة الحظر لها الأولوية على التكرارات. يؤدي التطابق المؤكد مع قائمة الحظر إلى كتم DUPLICATED_FACE، ويؤدي التطابق المحتمل مع قائمة الحظر إلى كتم POSSIBLE_DUPLICATED_FACE — فلن تحصل أبداً على كلا طرفي الزوج لنفس نطاق الثقة.
• يشير additional_data إلى أول وجه مطابق فقط، حتى لو كانت matches[] تحتوي على عدة وجوه. تحمل تحذيرات قائمة الحظر {blocklisted_session_id, blocklisted_session_number, api_service}؛ وتحمل تحذيرات التكرار {duplicated_session_id, duplicated_session_number, api_service}؛ بينما يحمل MULTIPLE_FACES_DETECTED القيمة null. تكون قيمة api_service بالأحرف الكبيرة (مثل PASSIVE_LIVENESS) أو null لجلسات سير العمل.
• الوجوه المدرجة في قائمة السماح تكتم تحذيرات التكرار — يؤدي تطابق قائمة السماح عالي الثقة إلى إزالة DUPLICATED_FACE/POSSIBLE_DUPLICATED_FACE (ولا يؤدي أبداً إلى إزالة تحذيرات قائمة الحظر).

​

نصوص التحذيرات الدقيقة

​

بوابة التحقق من صورة البحث

​

الإعدادات القابلة للتهيئة

• search_type (القيمة most_similar، الافتراضية | blocklisted_or_approved) — يرتب خيار most_similar جميع الوجوه المسجلة بحسب درجة التشابه؛ بينما يقصر خيار blocklisted_or_approved المرشحين على الوجوه المدرجة في قائمة الحظر، والوجوه المدرجة في قائمة السماح، والوجوه المستخرجة من الجلسات المقبولة، ووجوه ملفات تعريف المستخدمين المستوردة، مع ترتيب المدخلات المدرجة في قائمة الحظر أولاً.
• save_api_request (القيمة الافتراضية true) — يحفظ الاستدعاء كجلسة من نوع API ويسجل الوجه الذي تم البحث عنه في فهرس البحث بالوجه الخاص بك. يتم استبعاد الوجوه المسجلة عبر استدعاءات البحث بالوجه من نتائج البحث بالوجه المستقبلية. عيّنه على false للاستعلام دون حفظ أو تسجيل.
• rotate_image (القيمة الافتراضية false) — يجرّب تدويرات للصورة بزاوية 90 درجة ويحتفظ بالاتجاه الذي يحقق أفضل اكتشاف للوجه؛ وهو مفيد عندما تكون بيانات اتجاه EXIF مفقودة.

​

أمثلة

​

مطابقة في قائمة الحظر (تفرض Declined)

{
  "warnings": [
    {
      "risk": "FACE_IN_BLOCKLIST",
      "feature": "LIVENESS",
      "additional_data": {
        "blocklisted_session_id": "882c42d5-8a4d-4d20-8080-a22f57822c86",
        "blocklisted_session_number": 323442,
        "api_service": "PASSIVE_LIVENESS"
      },
      "log_type": "error",
      "short_description": "Face in blocklist",
      "long_description": "The system identified a face in the blocklist, which means the face is not allowed to be verified."
    }
  ]
}

​

إشارة تكرار (تبقى الحالة Approved)

{
  "warnings": [
    {
      "risk": "MULTIPLE_FACES_DETECTED",
      "feature": "LIVENESS",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Multiple faces detected",
      "long_description": "Multiple faces were detected in the liveness image. The system uses the largest face for liveness verification and face comparison, but the presence of multiple faces may require additional review."
    },
    {
      "risk": "DUPLICATED_FACE",
      "feature": "LIVENESS",
      "additional_data": {
        "duplicated_session_id": "1f2e3d4c-5b6a-7980-1122-334455667788",
        "duplicated_session_number": 1024,
        "api_service": null
      },
      "log_type": "information",
      "short_description": "Duplicated face from other approved session",
      "long_description": "The system identified a duplicated face from another approved session, requiring further investigation."
    }
  ]
}

​

ذات صلة

• تقرير البحث بالوجه — شكل الاستجابة الكامل
• مرجع API للبحث بالوجه — معلمات الطلب
• تحذيرات مطابقة الوجه — تحذيرات المقارنة بنسبة 1:1 بين صورة السيلفي والمستند (منفصلة عن البحث بالوجه)
• نماذج البيانات — البحث بالوجه — المخطط القياسي

​

أنواع التحذيرات