Поиск по лицу 1:N: предупреждения и коды ошибок

​

Обзор

​

Формируемые предупреждения

• Список блокировки имеет приоритет над дубликатами. Подтверждённое совпадение со списком блокировки подавляет DUPLICATED_FACE, а возможное совпадение со списком блокировки подавляет POSSIBLE_DUPLICATED_FACE — вы никогда не получите оба элемента пары для одного и того же диапазона уверенности.
• additional_data ссылается только на первое совпавшее лицо, даже если matches[] содержит несколько. Предупреждения о списке блокировки содержат {blocklisted_session_id, blocklisted_session_number, api_service}; предупреждения о дубликатах содержат {duplicated_session_id, duplicated_session_number, api_service}; MULTIPLE_FACES_DETECTED содержит null. Значение api_service указывается в верхнем регистре (например, PASSIVE_LIVENESS) или равно null для сессий сценариев.
• Лица из списка разрешений подавляют предупреждения о дубликатах — совпадение со списком разрешений с высокой уверенностью снимает DUPLICATED_FACE/POSSIBLE_DUPLICATED_FACE (оно никогда не снимает предупреждения о списке блокировки).

​

Точные строки предупреждений

​

Проверка изображения для поиска

​

Настраиваемые параметры

• search_type (most_similar, по умолчанию | blocklisted_or_approved) — most_similar ранжирует все зарегистрированные лица по схожести; blocklisted_or_approved ограничивает круг кандидатов лицами из списка блокировки, лицами из списка разрешений, лицами из одобренных сессий и импортированными лицами из профилей пользователей, ранжируя записи из списка блокировки первыми.
• save_api_request (по умолчанию true) — сохраняет вызов как сессию типа API и регистрирует искомое лицо в вашем индексе поиска по лицу. Лица, зарегистрированные при вызовах Поиска по лицу, исключаются из будущих результатов Поиска по лицу. Установите значение false, чтобы выполнить запрос без сохранения и регистрации.
• rotate_image (по умолчанию false) — пробует повороты на 90 градусов и сохраняет ориентацию с наилучшим обнаружением лица; полезно, если отсутствуют данные EXIF об ориентации.

​

Примеры

​

Совпадение со списком блокировки (приводит к Declined)

{
  "warnings": [
    {
      "risk": "FACE_IN_BLOCKLIST",
      "feature": "LIVENESS",
      "additional_data": {
        "blocklisted_session_id": "882c42d5-8a4d-4d20-8080-a22f57822c86",
        "blocklisted_session_number": 323442,
        "api_service": "PASSIVE_LIVENESS"
      },
      "log_type": "error",
      "short_description": "Face in blocklist",
      "long_description": "The system identified a face in the blocklist, which means the face is not allowed to be verified."
    }
  ]
}

​

Сигнал о дубликате (статус остаётся Approved)

{
  "warnings": [
    {
      "risk": "MULTIPLE_FACES_DETECTED",
      "feature": "LIVENESS",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Multiple faces detected",
      "long_description": "Multiple faces were detected in the liveness image. The system uses the largest face for liveness verification and face comparison, but the presence of multiple faces may require additional review."
    },
    {
      "risk": "DUPLICATED_FACE",
      "feature": "LIVENESS",
      "additional_data": {
        "duplicated_session_id": "1f2e3d4c-5b6a-7980-1122-334455667788",
        "duplicated_session_number": 1024,
        "api_service": null
      },
      "log_type": "information",
      "short_description": "Duplicated face from other approved session",
      "long_description": "The system identified a duplicated face from another approved session, requiring further investigation."
    }
  ]
}

​

Связанные материалы

• Отчёт Face Search — полная структура ответа
• Справочник API Face Search — параметры запроса
• Предупреждения Face Match — предупреждения при сравнении 1:1 селфи с документом (отдельно от Face Search)
• Модели данных — Face Search — каноническая схема

​

Типы предупреждений