跳转到主要内容
Human Token

Human Token 专为不涉及政府颁发证件关系的场景而设计——适用于出于隐私原因不希望共享证件号码的情况。其核心功能是通过单次自拍提交，为每张人脸创建唯一身份标识。

这使您能够：

  • 检测复访用户并防止重复账号 — 识别同一用户是否再次访问或尝试创建多个账号，在无需官方证件的情况下实现一致的身份识别。
  • 通过 Web、Native 或 API 集成 — 仅以自拍图像作为输入，无需提供额外的证件数据。
  • 与其他信号组合使用 — 可根据需要将 Human Token 与其他能力结合使用。

功能说明​

Human Token 根据采集到的自拍，生成一个稳定的、不透明的生物特征标识符（personId），用于唯一代表该人脸。用户无需声明任何标识符——身份是调用的输出，而非输入。每次匹配成功时，响应都会返回相同的 personId，使系统能够在后续流程中识别同一用户。

输入​

自拍由 SDK 或 Web Journey 采集。对于无头 API 集成，图像以 imagebase64 形式在 POST /processes/v1 的请求体中发送。请勿包含 subject.code——Human Token 会在响应中返回 personId。

需要 SDK 以保障采集质量

为确保通过 API 发送的图像满足生物特征要求，请使用适用于您平台的 Unico SDK 或遵循采集标准。Human Token 不接受未经采集质量控制的任意图像。

可能的响应​

idFace.result含义
FOUND身份已解析。personId 已返回并填充。
无法生成 personId 的情况

存在一种 Human Token 无法产生 personId 的场景：无法在提交的图像中识别出人脸——未检测到人脸、图像质量过低，或人脸不符合采集标准（倾斜、侧向）。这并非一个 result 值：请求会失败，返回20532 — No face detected in image。遵循采集标准可避免这种情况。

响应示例​

{
  "id": "1c1fc38b-7e98-4f9a-a04d-7a4a8b29d2c1",
  "status": 3,
  "idFace": {
    "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
    "result": "FOUND"
  }
}

personId 是一个稳定的、不透明的标识符——同一用户始终解析为相同的值。请将其存储在您的用户记录旁边，以便在后续 Human Token 调用中识别同一用户。

可用性​

接入方式是否支持
SDK（Android、iOS、Flutter）✅
Web（iFrame、Redirect）✅
API（无头，无 SDK）✅
最后更新 于