检索活跃用户
无活体的 1:N 人脸检索 — 适用于活跃用户与会话类流程（单张探针图）。
menu_bookAPI 参考：人脸检索 1:N（活跃用户）expand_more
官方文档： docs.verifik.co/biometrics/search-active-user （无活体的 1:N检索 — 活跃用户/会话流程）。
基础 URL 为 https://api.verifik.co。在 image 中发送一张原始 base64 探针图，必填 os（ANDROID、IOS 或 DESKTOP），以及 min_score 与 search_mode。本演示使用 DESKTOP。
POST /v2/face-recognition/search-active-user
与活体检索类似，但探针图无活体门槛 — 适用于用户已处于已认证或可信会话时。
| 字段 | 值 |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| 参数 | 必填 | 说明 |
|---|---|---|
| image | 是 | 单张 base64 探针图 |
| os | 是 | ANDROID、IOS 或 DESKTOP |
| min_score | 是 | 匹配阈值（0.5–1.0） |
| search_mode | 是 | FAST 或 ACCURATE |
| collection_id | 否 | 将检索限定在单个人脸库 |
await fetch("https://api.verifik.co/v2/face-recognition/search-active-user", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
image: "<base64>",
os: "DESKTOP",
min_score: 0.75,
search_mode: "FAST",
collection_id: "<optionalCollectionMongoId>",
}),
});- 本演示使用 @humanauthn/api-client 的 searchActiveUser 及您的会话令牌。
- 若需活体 + 1:N，请改用 search-live-face（见文档中的人脸检索 1:N 活体）。
menu_book
相关文档
docs.verifik.co 官方指南