إنشاء شخص مع الحضور الحي
تسجيل + فحص الحضور الحي + بحث إزالة التكرار في طلب واحد.
menu_bookمرجع API: إنشاء شخص مع الحضور الحيexpand_more
الوثائق الرسمية (الإنجليزية): docs.verifik.co/resources/create-a-person-with-liveness
الوثائق (الإسبانية): docs.verifik.co/verifik-es/resources/personas/crear-una-persona-con-deteccion-de-vida
عنوان الأساس https://api.verifik.co. أرسل JSON بحقول الملف وcollection_id واحد (_id للمجموعة) وعتبات الحضور الحي والبحث وصورة وجه base64 واحدة على الأقل لكل عنصر في images (بدون بادئة data URL).
POST /v2/face-recognition/persons/search-live-face
يشغّل الحضور الحي على الوجه/الوجوه المُرسلة، يبحث عن تسجيلات مشابهة، ثم ينشئ أو يحدّث شخصًا في المجموعة المستهدفة.
| العنوان | القيمة |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| المعامل | إلزامي | الوصف |
|---|---|---|
| name | نعم | اسم العرض |
| images | نعم | مصفوفة صور وجه base64 (base64 خام، وليست عناوين بيانات) |
| gender | نعم | M أو F |
| date_of_birth | نعم | YYYY-MM-DD |
| collection_id | نعم | معرّف فريد لمجموعة واحدة |
| liveness_min_score | نعم | 0.5–1 |
| min_score | نعم | عتبة بحث داخلية، 0.5–1 |
| search_mode | نعم | FAST أو ACCURATE |
| nationality | لا | اختياري |
await fetch("https://api.verifik.co/v2/face-recognition/persons/search-live-face", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
name: "Jane Doe",
gender: "F",
date_of_birth: "1990-01-15",
collection_id: "<collectionMongoId>",
liveness_min_score: 0.65,
min_score: 0.8,
search_mode: "FAST",
nationality: "CO",
images: ["<base64>", "<base64>"],
}),
});- يستخدم هذا العرض دالة createPersonWithLiveness من @humanauthn/api-client مع رمز الجلسة.
- قد تتضمن الاستجابات كتلة توقيع إلى جانب البيانات حسب البيئة.
الوثائق ذات الصلة
أدلة رسمية على docs.verifik.co
كائن الشخص
الحقول وبنية سجل شخص التعرف على الوجوه.
قائمة كل الأشخاص
أشخاص عميلك مع مرشحات اختيارية.
استرجاع شخص
شخص واحد بالمعرّف.
تحديث شخص
الملف والصور والمجموعات وأكثر.
حذف شخص
إزالة سجل شخص بالمعرّف.
إنشاء شخص مع الحضور الحي
الحضور الحي وبحث التكرار والتسجيل في طلب واحد.
تحديث شخص (عرض)
تغيير الملف أو المجموعات لمعرّف شخص قائم.
حذف شخص (عرض)
حذف كامل أو الإزالة من مجموعة واحدة فقط.