Перейти к основному содержимому
Версия: 1.6.0

Объект Validations

Validations — это объект, содержащий результаты проверок, выполненных для попытки. Объект возвращается в ответ на запросы Validation, Applicants и т.д. по ключу validations.

Validations содержит несколько блоков проверок.

Liveness

Различные проверки Liveness.

Объект содержит поле verdict, которое формируется из verdict-s всех подблоков путем конъюнкции. Поле вердикт может быть нулевым, если не проводились проверки Liveness.

Данные подблоков хранятся в списке под ключом details. Каждый подблок хранит следующие поля:

  • verdict — результат верификации.
  • score — результат верификации.
  • name — имя верификации.
примечание

Если проверка отключена, то она будет отсутствовать в списке details.
Если провека должна была выполниться, но не выолнилась, то поле подблока verdict будет иметь значение null

Возможны следующие подблоки:

  • FaceLiveness (проверка Liveness лица).
  • LivenessReflection (проверка видео на отражение).

Качество

Различные проверки качества.

Объект содержит поле verdict, которое формируется из verdict-s всех подблоков путем конъюнкции. Поле вердикт может быть нулевым, если не проводились проверки качества.

Данные подблоков хранятся в списке под ключом details. Каждый подблок хранит следующие поля:

  • verdict — результат верификации.
  • score — результат верификации.
  • name — имя верификации.
примечание

Если проверка отключена, то она будет отсутствовать в списке details.
Если провека должна была выполниться, но не выполнилась, то поле подблока verdict будет иметь значение null

Возможны следующие подблоки:

  • FaceQuality (проверка качества изображения лица).

Сравнение

Сравнение лиц и поиск по базе.

Объект содержит поле verdict, которое формируется из verdict-s всех подблоков путем конъюнкции. Поле вердикт может быть нулевым, если не проводились сравнения.

Данные подблоков хранятся в списке под ключом details. Каждый подблок хранит следующие поля:

  • verdict — результат верификации.
  • score — результат верификации.
  • name — имя верификации.
примечание

Если проверка отключена, то она будет отсутствовать в списке details.
Если провека должна была выполниться, но не выолнилась, то поле подблока verdict будет иметь значение null

Возможны следующие подблоки:

  • FaceMatching (поиск лица по базе или сравнение с регистрационным фото).
  • McCrossMatch (сравнение лица из видеозаписи с контролем движения с эталонным).
  • LrCrossMatch (сравнение лица из видеозаписи с живостью с эталонным).

MotionControl

Проверка результатов видео контроля движений.

Объект содержит поле verdict, которое может принимать следующие значения:

  • true — все действия были выполнены правильно.
  • false — одно из действий было выполнено неправильно.
  • null — попытка не содержит данных об контроле движений.

Поле motionControlInfo содержит данные о результатах контроля движения.

Данные представляют собой список, каждый элемент которого является объектом со следующими полями:

  • pattern — имя выполняемого паттерна (up, right, left, closer, farther).
  • result - правильность выполнения паттерна пользователем.

Пример объекта validations:

{
"liveness": {
"verdict": true,
"details": [
{
"name": "FaceLiveness",
"verdict": true,
"score": 0.99
}
]
},
"quality": {
"verdict": true,
"details": [
{
"name": "FaceQuality",
"verdict": true,
"score": 0.53
}
]
},
"matching": {
"verdict": true,
"details": [
{
"name": "FaceMatching",
"verdict": true,
"score": 0.0
}
]
},
"motionControl": {
"verdict": false,
"motionControlInfo": [
{
"pattern": "up",
"result": true
},
{
"pattern": "left",
"result": false
}
]
}
}