Объект 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
}
]
}
}