创建人员
使用人脸图像与元数据注册新人员。
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-Type | application/json |
| Authorization | Bearer <token> |
| 参数 | 必填 | 说明 |
|---|---|---|
| name | 是 | 显示名称 |
| images | 是 | base64 人脸图像数组(原始 base64,非 data URL) |
| gender | 是 | M 或 F(本演示必填) |
| date_of_birth | 是 | YYYY-MM-DD(本演示必填) |
| collections | 是 | collection _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 官方指南