사람 등록

사람 만들기

얼굴 이미지와 메타데이터를 사용하여 새 사람을 등록하세요.

menu_bookAPI 참조: 사람 만들기expand_more

공식 문서: docs.verifik.co/resources/create-a-person

Base URL https://api.verifik.co. Send JSON with profile fields and at least one base64 face image per entry in images (no data URL prefix). The public docs also list optional fields such as notes, email, and phone.

POST /v2/face-recognition/persons

Verifik 지원 인식을 위한 얼굴 생체 인식을 사용하여 지정된 컬렉션 ID(컬렉션 _id 값)에 새 사람을 등록합니다.

헤더	값
Content-Type	application/json
Authorization	Bearer <token>

매개변수	요청	설명
이름	예	표시 이름
이미지	예	base64 얼굴 이미지 배열(데이터 URL이 아닌 원시 base64)
성별	예	M 또는 F(이 데모에서는 필수)
생일	예	YYYY-MM-DD(이 데모에 필요)
컬렉션	예	컬렉션 _id 문자열 배열; 이 데모에서는 GET /v2/face-recognition/collections에서 이를 로드하고 하나 이상을 선택할 수 있습니다.
국적	아니요	선택적 국가/국적 코드 또는 라벨

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": ["…"],
    "…": "…"
  }
}