✅ Верификация liveness данных

Code samples

POST /webapi/kyc/user/{uuid}/liveness/verify

Body parameter

{
  "challengeToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "frames": [
    {
      "challengeIndex": 0,
      "image": "data:image/jpeg;base64,...",
      "landmarks": {},
      "blendshapes": {},
      "headPose": {},
      "timestamp": 1701424800.123
    }
  ],
  "antiSpoofing": { "score": 0.99 },
  "passport": "data:image/png;base64,...",
  "documentType": "passport",
  "country": "ru"
}

🛠️ Параметры

Name	In	Type	Required	Description
uuid	path	string(uuid)	true	UUID верификации
challengeToken	body	string	true	Токен из `/liveness/start`
frames	body	object[]	true	Кадры с лицом пользователя
frames[].challengeIndex	body	integer	true	Индекс задания
frames[].image	body	string	true	Изображение кадра в base64
frames[].landmarks	body	object	false	Ключевые точки лица
frames[].blendshapes	body	object	false	Blendshapes лица
frames[].headPose	body	object	false	Положение головы
frames[].timestamp	body	number	true	Unix timestamp кадра
antiSpoofing	body	object	true	Данные антиспуфинга
passport	body	string	true	Фото документа в base64
documentType	body	string	true	Тип документа
country	body	string	true	Страна (ISO-код)

Example responses

200 Response

{
  "success": true,
  "score": 0.97,
  "passed": true,
  "details": {
    "livenessScore": 0.97,
    "faceMatchScore": 0.94,
    "antiSpoofingScore": 0.99
  }
}

🔁 Ответы

Status	Meaning	Description	Schema
200	OK	Результат проверки	Inline
404	Not Found	Верификация не найдена	Inline
422	Unprocessable Entity	Ошибка валидации	Inline

📋 Response Schema

Name	Type	Description
success	boolean	Успех операции
score	number	Итоговый балл (0–1)
passed	boolean	Прошла ли проверка
details	object	Детализация результатов