البحث عن مستخدم نشط

بحث وجه 1:N دون حضور حي — لتدفقات المستخدم النشط وأسلوب الجلسة (صورة استطلاع واحدة).

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

الوثائق الرسمية: docs.verifik.co/biometrics/search-active-user (بحث 1:N دون حضور حي — تدفقات المستخدم النشط / الجلسة).

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

POST /v2/face-recognition/search-active-user

مشابه للبحث المباشر، لكن دون بوابة الحضور الحي — للاستخدام عندما يكون المستخدم بالفعل في جلسة مصادَق عليها أو موثوقة.

العنوان	القيمة
Content-Type	application/json
Authorization	Bearer <token>

المعامل	إلزامي	الوصف
image	نعم	صورة استطلاع base64 واحدة
os	نعم	ANDROID أو IOS أو DESKTOP
min_score	نعم	عتبة المطابقة (0.5–1.0)
search_mode	نعم	FAST أو ACCURATE
collection_id	لا	حصر البحث في مجموعة واحدة

await fetch("https://api.verifik.co/v2/face-recognition/search-active-user", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    image: "<base64>",
    os: "DESKTOP",
    min_score: 0.75,
    search_mode: "FAST",
    collection_id: "<optionalCollectionMongoId>",
  }),
});

يستخدم هذا العرض دالة searchActiveUser من @humanauthn/api-client مع رمز الجلسة.
للحضور الحي + 1:N، استخدم search-live-face بدلًا من ذلك (انظر Face Search 1:N Live في الوثائق).

menu_book

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

Object

كائن الشخص

الحقول وبنية سجل شخص التعرف على الوجوه.

GET

قائمة كل الأشخاص

أشخاص عميلك مع مرشحات اختيارية.

GET

استرجاع شخص

شخص واحد بالمعرّف.

PUT