创建人员

创建人员

使用人脸图像与元数据注册新人员。

menu_bookAPI 参考:创建人员expand_more

官方文档: docs.verifik.co/resources/create-a-person

基础 URL为 https://api.verifik.co。发送包含档案字段的 JSON,且 images 中每项至少一张 base64 人脸图(无 data URL 前缀)。公开文档还列出 notes、email、phone 等可选字段。

POST /v2/face-recognition/persons

将新人员注册到给定人脸库 id(collection _id),并附带用于 Verifik 识别的人脸生物特征。

字段
Content-Typeapplication/json
AuthorizationBearer <token>
参数必填说明
name显示名称
imagesbase64 人脸图像数组(原始 base64,非 data URL)
genderM 或 F(本演示必填)
date_of_birthYYYY-MM-DD(本演示必填)
collectionscollection _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": ["…"],
    "…": "…"
  }
}
  • 本演示使用 @humanauthn/api-client 的 createPerson 及您的会话令牌。
  • 响应可能包含 id 与签名字段,视环境而定。
menu_book

docs.verifik.co 官方指南