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