Перейти к основному содержимому
Human Token

Human Token предназначен для сценариев, в которых отсутствует связь с документом, удостоверяющим личность, — ситуаций, когда клиенты хотят избежать передачи номеров документов из соображений конфиденциальности. Его основная функция — создать уникальную идентичность для каждого лица на основе единственного селфи.

Это позволяет вам:

  • Выявлять повторяющихся пользователей и предотвращать создание дублирующих аккаунтов — распознавать, возвращается ли тот же человек или пытается создать несколько аккаунтов, обеспечивая стабильное распознавание личности без официальных документов.
  • Интегрироваться через Web, Native или API — используя только селфи в качестве входных данных, без каких-либо дополнительных данных документа.
  • Комбинировать с другими сигналами — добавлять Human Token вместе с другими возможностями по мере необходимости.

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

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

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

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