IdFace

IdFace 从自拍中生成唯一标识符。用户无需以任何方式输入或声明标识符——身份是调用的输出，而非输入。匹配成功时，响应返回一个稳定的、不透明的 person_id，该标识符在不同流程中唯一标识该用户。

功能说明

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

输入

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

需要 SDK 以保障采集质量

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

可能的响应

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

响应示例

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

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

可用性

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

使用此能力的用例

• 人脸识别