البحث عن شخص حي

البحث عن شخص حي

الحضور الحي على صورة استطلاع واحدة، ثم بحث وجه 1:N (مباشر).

menu_bookمرجع API: Face Search 1:N (Live)expand_more

الوثائق الرسمية: docs.verifik.co/biometrics/search-live-face (الحضور الحي على صورة الاستطلاع، ثم بحث 1:N).

عنوان الأساس https://api.verifik.co. أرسل صورة استطلاع base64 واحدة خام في image (بدون بادئة data URL)، وos المطلوب (ANDROID أو IOS أو DESKTOP)، وعتبات الحضور الحي والمطابقة، وsearch_mode. يستخدم هذا العرض DESKTOP.

POST /v2/face-recognition/search-live-face

يشغّل مكافحة التزييف / الحضور الحي أولًا؛ عند النجاح يجري بحث التشابه ضد الوجوه المسجّلة.

العنوانالقيمة
Content-Typeapplication/json
AuthorizationBearer <token>
المعاملإلزاميالوصف
imageنعمصورة استطلاع base64 واحدة
osنعمANDROID أو IOS أو DESKTOP
liveness_min_scoreنعمعتبة الحضور الحي (0.5–1.0)
min_scoreنعمعتبة المطابقة (0.5–1.0 حسب الوثائق)
search_modeنعمFAST أو ACCURATE
collection_idلاحصر البحث في مجموعة واحدة
await fetch("https://api.verifik.co/v2/face-recognition/search-live-face", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    image: "<base64>",
    os: "DESKTOP",
    liveness_min_score: 0.65,
    min_score: 0.75,
    search_mode: "FAST",
    collection_id: "<optionalCollectionMongoId>",
  }),
});
  • يستخدم هذا العرض دالة searchLivePerson من @humanauthn/api-client مع رمز الجلسة.
  • عندما تكون درجة الحضور الحي دون العتبة المحدّدة، قد تُعاد استجابة خطأ (راجع الوثائق لأشكال الأخطاء).
menu_book

أدلة رسمية على docs.verifik.co