Human Token

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

يتيح لك ذلك:

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

ما الذي تفعله

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

المدخلات

تُلتقط الصورة الشخصية عبر SDK أو Web Journey. لتكامل API بدون واجهة، تُرسَل الصورة بصيغة imagebase64 في جسم طلب POST /processes/v1. لا تُدرج subject.code — يُعيد Human Token personId في الاستجابة.

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

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

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

idFace.result	المعنى
FOUND	تم التعرف على الهوية. personId مُعاد ومُعبَّأ.

عندما يتعذّر توليد personId

هناك سيناريو واحد فقط لا يُنتج فيه Human Token قيمة personId: تعذّر التعرف على الوجه في الصورة المُرسلة — لم يُكتشف أي وجه، أو كانت جودة الصورة منخفضة جدًا، أو كان الوجه خارج معيار الالتقاط (مائل، أو موجّه إلى الجانب). هذه ليست قيمة من قيم result: يفشل الطلب برمز 20532 — No face detected in image. اتّباع معيار الالتقاط هو ما يمنع حدوث ذلك.

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

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

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

التوفر

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