البحث عن شخص حي
الحضور الحي على صورة استطلاع واحدة، ثم بحث وجه 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-Type | application/json |
| Authorization | Bearer <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