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

# Объект Validations

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

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

### Liveness​

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

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

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

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

примечание

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

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

- FaceLiveness - проверка живости лица.
- DeepFake - проверка на наличие признаков использования технологии DeepFake. (Экспериментальная функциональность)

### Качество​

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

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

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

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

примечание

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

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

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

### Сравнение​

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

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

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

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

примечание

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

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

- FaceMatching - поиск лица по базе или сравнение с регистрационным фото.

### 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,
            "additionalInfo": null
          },
          {
            "name": "DeepFake",
            "verdict": false,
            "score": 0.001,
            "additionalInfo": null
          }
        ]
      },
      "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
          }
        ]
      }
    }