Face Identifier

Face Identifier مصمَّم للسيناريوهات التي لا توجد فيها علاقة بوثيقة حكومية — الحالات التي يرغب فيها العملاء بتجنب مشاركة أرقام وثائقهم لأسباب تتعلق بالخصوصية. وظيفته الأساسية هي إنشاء هوية فريدة لكل وجه من خلال تقديم صورة شخصية واحدة.

يتيح لك ذلك:

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

ما الذي تفعله

من الصورة الشخصية الملتقطة، يُولّد Face Identifier معرّفًا بيومتريًا مستقرًا وغير شفاف (personId) يمثّل ذلك الوجه بصورة فريدة. لا يُعلن المستخدم عن أي معرّف — الهوية هي نتيجة الاستدعاء وليست مدخلًا له. عند كل مطابقة ناجحة، تُعيد الاستجابة نفس personId، مما يتيح التعرف على المستخدم ذاته في العمليات المستقبلية.

المدخلات

تُلتقط الصورة الشخصية عبر SDK أو رحلة الويب. لتكامل API بدون واجهة، يُرسَل الصورة بصيغة imagebase64 في جسم طلب POST /v1/process مع flow=idface. لا تُدرج subject.code — يُعيد Face Identifier personId في الاستجابة.

SDK مطلوب لالتقاط عالي الجودة

لضمان أن الصورة المُرسلة عبر API تستوفي المتطلبات البيومترية، استخدم Unico SDK لمنصتك أو اتّبع معيار الالتقاط. لا يقبل Face Identifier صورًا اعتباطية دون التحكم في جودة الالتقاط.

الاستجابات المحتملة

idFace.result	المعنى
FOUND	تأكيد الهوية. personId مُعاد ومُعبَّأ.
NOT_FOUND	لم تتأكد الهوية. personId سيكون غائبًا.

مثال على الاستجابة

{
  "id": "1c1fc38b-7e98-4f9a-a04d-7a4a8b29d2c1",
  "status": 3,
  "idFace": {
    "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
    "result": "FOUND"
  }
}

personId معرّف مستقر وغير شفاف — سيُحلَّل المستخدم ذاته دائمًا إلى القيمة نفسها. احفظه جنبًا إلى جنب مع سجل المستخدم لديك للتعرف على الشخص ذاته في استدعاءات Face Identifier اللاحقة.

التوفر

السطح	مدعوم
SDK (Android، iOS، Flutter)	✅
ويب (iFrame، إعادة توجيه)	✅
API (بدون واجهة، بدون SDK)	✅