إنشاء شخص

سجّل شخصًا جديدًا بصور الوجه والبيانات الوصفية.

menu_bookمرجع API: إنشاء شخصexpand_more

الوثائق الرسمية: docs.verifik.co/resources/create-a-person

عنوان الأساس https://api.verifik.co. أرسل JSON بحقول الملف وصورة وجه base64 واحدة على الأقل لكل عنصر في images (بدون بادئة data URL). تذكر الوثائق العامة حقولًا اختيارية مثل الملاحظات والبريد والهاتف.

POST /v2/face-recognition/persons

يسجّل شخصًا جديدًا في معرّفات المجموعات المعطاة (قيم _id للمجموعة) مع بيومترية الوجه للتعرّف المدعوم بـ Verifik.

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

المعامل	إلزامي	الوصف
name	نعم	اسم العرض
images	نعم	مصفوفة صور وجه base64 (base64 خام، وليست عناوين بيانات)
gender	نعم	M أو F (إلزامي في هذا العرض)
date_of_birth	نعم	YYYY-MM-DD (إلزامي في هذا العرض)
collections	نعم	مصفوفة سلاسل _id للمجموعة؛ يحمّلها هذا العرض من GET /v2/face-recognition/collections وتختار واحدة أو أكثر.
nationality	لا	رمز أو تسمية بلد / جنسية اختيارية

await fetch("https://api.verifik.co/v2/face-recognition/persons", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    name: "Jane Doe",
    gender: "F",
    date_of_birth: "1990-01-15",
    collections: ["<collectionMongoId>"],
    nationality: "CO",
    images: ["<base64>", "<base64>"],
  }),
});

// 200 OK — example shape
{
  "data": {
    "id": "…",
    "name": "Jane Doe",
    "gender": "F",
    "date_of_birth": "1990-01-15",
    "collections": ["…"],
    "…": "…"
  }
}