يُولّد IdFace معرّفًا فريدًا من صورة شخصية. لا يكتب المستخدم أو يُعلن عن أي معرّف بأي طريقة أخرى — الهوية هي نتيجة الاستدعاء وليست مدخلًا له. عند كل مطابقة ناجحة، تُعيد الاستجابة معرّفًا مستقرًا وغير شفاف (person_id) يُعرّف المستخدم بصورة فريدة عبر جميع العمليات.
ما الذي تفعله
من الصورة الشخصية الملتقطة، يُولّد IdFace معرّفًا بيومتريًا مستقرًا وغير شفاف (person_id) يمثّل ذلك الوجه بصورة فريدة. لا يُعلن المستخدم عن أي معرّف — الهوية هي نتيجة الاستدعاء وليست مدخلًا له. عند كل مطابقة ناجحة، تُعيد الاستجابة نفس person_id، مما يتيح التعرف على المستخدم ذاته في العمليات المستقبلية.
المدخلات
تُلتقط الصورة الشخصية عبر SDK أو رحلة الويب. لتكامل API بدون واجهة، يُرسَل الصورة بصيغة imagebase64 في جسم طلب POST /v1/process مع flow=idface. لا تُدرج subject.code — يُعيد IdFace person_id في الاستجابة.
لضمان أن الصورة المُرسلة عبر API تستوفي المتطلبات البيومترية، استخدم Unico SDK لمنصتك أو اتّبع معيار الالتقاط. لا يقبل IdFace صورًا اعتباطية دون التحكم في جودة الالتقاط.
الاستجابات المحتملة
idFace.result | المعنى |
|---|---|
FOUND | تأكيد الهوية. person_id مُعاد ومُعبَّأ. |
NOT_FOUND | لم تتأكد الهوية. person_id سيكون غائبًا. |
مثال على الاستجابة
{
"id": "1c1fc38b-7e98-4f9a-a04d-7a4a8b29d2c1",
"status": 3,
"idFace": {
"person_id": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
"result": "FOUND"
}
}
person_id معرّف مستقر وغير شفاف — سيُحلَّل المستخدم ذاته دائمًا إلى القيمة نفسها. احفظه جنبًا إلى جنب مع سجل المستخدم لديك للتعرف على الشخص ذاته في استدعاءات IdFace اللاحقة.
التوفر
| السطح | مدعوم |
|---|---|
| SDK (Android، iOS، Flutter) | ✅ |
| ويب (iFrame، إعادة توجيه) | ✅ |
| API (بدون واجهة، بدون SDK) | ✅ |