IdFace

IdFace генерирует уникальный идентификатор на основе селфи. Пользователь не вводит и не указывает идентификатор никаким другим способом — личность является результатом вызова, а не входными данными. При успешном совпадении ответ возвращает стабильный непрозрачный person_id, который однозначно идентифицирует пользователя во всех процессах.

Что это делает

На основе захваченного селфи IdFace генерирует стабильный непрозрачный биометрический идентификатор (person_id), который однозначно представляет это лицо. Пользователь не объявляет никакого идентификатора — личность является результатом вызова, а не входными данными. При каждом успешном совпадении ответ возвращает тот же person_id, что позволяет распознавать одного и того же пользователя в будущих процессах.

Входные данные

Селфи захватывается с помощью SDK или веб-интеграции. При headless-интеграции через 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 (headless, без SDK)	✅

Сценарии использования этой возможности

• Идентификация по лицу