إنشاء شخص مع الحضور الحي

إنشاء شخص مع الحضور الحي

تسجيل + فحص الحضور الحي + بحث إزالة التكرار في طلب واحد.

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-Typeapplication/json
AuthorizationBearer <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 مع رمز الجلسة.
  • قد تتضمن الاستجابات كتلة توقيع إلى جانب البيانات حسب البيئة.
menu_book

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