跳转到主要内容
Face Identifier

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

这使您能够：

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

功能说明​

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

输入​

自拍由 SDK 或 Web 旅程采集。对于无头 API 集成，图像以 imagebase64 形式在 POST /v1/process 的请求体中发送，并指定 flow=idface。请勿包含 subject.code——Face Identifier 会在响应中返回 personId。

需要 SDK 以保障采集质量

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

可能的响应​

idFace.result含义
FOUND身份已确认。personId 已返回并填充。
NOT_FOUND身份未确认。personId 将不存在。

响应示例​

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

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

可用性​

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