البحث عن شخص

ارفع صور وجه للبحث عن أشخاص مسجّلين بالتشابه (1:N).

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

الوثائق الرسمية: docs.verifik.co/biometrics/search (Face Search — البحث بصورة وجه ضد الأشخاص المسجلين).

عنوان الأساس https://api.verifik.co. أرسل صورة أو أكثر base64 خام لنفس الشخص في images (بدون بادئة data URL). يمكن حصر النطاق بـ collection_id. توصي الوثائق العامة بـ 1–3 صور لاستدعاء أفضل.

POST /v2/face-recognition/search

تحديد 1:N: يعيد أشخاصًا مرشحين مرتبين بدرجة التشابه.

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

المعامل	إلزامي	الوصف
images	نعم	مصفوفة صور وجه base64 (نفس الشخص؛ يُقترح حتى ~3)
min_score	نعم	عتبة المطابقة (مثل 0.2–1.0)
search_mode	نعم	FAST أو ACCURATE
collection_id	لا	حصر البحث في مجموعة واحدة
max_results	لا	حد أقصى للمطابقات المُرجعة (يُطبَّق الافتراضي لواجهة البرمجة عند الحذف)

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