Human Token

Markdown

只需一张人脸照片，即可将您的用户转化为一个独一无二的人。简单、直观且安全。

一个人。一个 Token。始终如此。 Human Token 通过单张自拍为每张人脸创建唯一身份标识，无需政府颁发的证件。无论是在不存在这种关联的场景，还是在客户不愿共享证件号码的场景，都同样适用。需要时，随时发起新的验证并比较 Token：Token 相同即代表同一个人。

这使您能够：

• 检测复访用户并防止重复账号：一张人脸，一个 Token。无需官方证件，即可在注册、登录和账号找回环节识别重复或虚假账号。
• 通过 Web、Native 或 API 集成：仅以自拍图像作为输入，无需提供额外的证件数据。
• 与其他信号结合使用：根据需要，将 Human Token 与其他 capabilities 搭配使用。

最常见的场景包括深度伪造攻击（无需 CAPTCHA 和短信，即可确认每个操作背后都有一个真实且在场的人）、多账号、促销和推荐滥用、密码找回、新设备认证以及降低违约率。在决策之前评估风险，而不是在损失之后。

功能说明

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

Privacy by Design： 无需任何预先数据，人脸照片可在处理后丢弃：保留在您系统中的是 Token，而不是人脸——从而显著降低贵公司及您客户的生物特征数据暴露风险。

输入

唯一的输入是自拍。使用 API Only 流程时，您的后端以 imageBase64 形式在创建流程的请求体中发送自拍。使用 Human Token Journey 流程（humantoken 或 humantoken+revalidation）时，自拍在旅程中采集。

需要 SDK 以保障采集质量

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

可能的响应

结果位于 data.humanToken 中：value 是标识符，state 表示流程所处的阶段——结果就绪时为 PROCESS_STATE_FINISHED。参见创建流程 › 解读结果。

无法生成 humanToken 的情况

Human Token 仅在一种情况下不会生成 humanToken：无法在提交的图像中识别出人脸——未检测到人脸、图像质量过低，或人脸不符合采集标准（倾斜、侧向）。遵循采集标准可避免这种情况。

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

API 集成

Human Token 运行在 Human API 上。您的后端通过创建流程创建流程：使用 API Only 流程（api+humantoken、api+liveness+humantoken 或 api+liveness+humantoken+revalidation）时，humanToken 会在同一响应中返回；使用 Human Token Journey 流程（humantoken 或 humantoken+revalidation）时，用户完成旅程后，您的后端通过获取流程获取结果。

开始使用：

1. 设置身份验证——每次调用都会在 x-unico-accesskey 请求头中发送您的访问密钥。
2. 通过创建流程创建流程，并读取 data.humanToken。
3. 需要时，通过获取流程再次查询该流程。

可用性

所需集成组件
API Web