Как провести проверку медиафайла на Liveness без использования фронтенда Oz

Oz API – это API для распознавания лиц: как для проверки Liveness, так и для биометрической проверки, то есть сравнения лиц между собой.

Ключевые преимущества Oz API:

• Сохранение данных – ваши медиафайлы и анализы хранятся для будущего использования, пока вы самостоятельно их не удалите

• Возможность работать и с фото, и с видео

• Асинхронность анализов

• Безопасная аутентификация

• Гибкая настройка уровней доступа

Основная сущность в Oz API – это папка: в папку вы можете загружать медиафайлы, запускать для них анализы и получать результаты не только для отдельных анализов, но и для папки в целом.

Здесь мы приводим пошаговую инструкцию по проведению проверки Liveness для фото или видео лица, которое вы уже сняли с помощью бэкенда Oz.

• Создание папки

• Загрузка медиафайла в папку

• Проверка Liveness

• Получение результатов

Для вашего удобства и повышения точности анализов мы рекомендуем использовать для съемки медиа наши Web или Mobile SDK. Как это сделать, описано здесь:

• Интеграция Oz Liveness Web SDK

• Интеграция Oz Liveness Mobile SDK

Чтобы начать, вам понадобятся логин и пароль. Напишите нам, и вы отправим вам всю необходимую информацию, включая ссылки:

Логин: [e-mail]

Пароль: …

API: https://sandbox.ohio.ozforensics.com

Web Console: https://sandbox.ohio.ozforensics.com

Со всеми методами Oz API можно ознакомиться здесь: коллекция Postman.

1. Получите токен доступа

Мы рекомендуем использовать токен доступа вместо логина и пароля, так как это более безопасно. Вызовите метод POST /api/authorize/auth. В теле запроса укажите логин и пароль

{
    "credentials": {
        "email": "<login>", // электронная почта для доступа администратора
        "password": "<password>" // полученный от нас пароль
     }
}

В ответе вам придет токен доступа. В дальнейшем его нужно будет указывать в поле X-Forensic-Access-Token.

2. Поместите отдельные фотографии в архивы (для версии 4.0.8 и ниже)

Внимание: если вы используете API версии 5.0.0 или новее, пропустите этот шаг.

В версии 4.0.8 и ниже проверка Oz Liveness может производиться либо по видео, либо по последовательности кадров в архиве. Таким образом, если вы хотите запустить проверку по одной фотографии, ее необходимо добавить в ZIP-архив. Oz API будет обрабатывать этот архив так же, как видео. Обратите внимание: теги к этому архиву необходимо указывать из списка тегов для видео.

3. Загрузите медиафайлы в папку

Чтобы создать папку и добавить в нее ваши фото и видео, вызовите метод POST /api/folders/ и добавьте медиафайлы в тело запроса.

В поле payload укажите следующие теги:

{
    "media:tags": {
        "video1": [
            "video_selfie",
            "video_selfie_blank",
            "orientation_portrait"
        ],
    }
}

В случае успеха вернется код 201. В ответе будет идентификатор папки folder_id – он понадобится в дальнейшем.

4. Запустите анализ

Для запуска анализа вызовите метод POST /api/folders/{{folder_id}}/analyses/ и укажите в нем folder_id из предыдущего шага. В теле запроса укажите анализ Liveness (Quality).

{
    "analyses": [
        {
            "type": "quality"
        }
    ]
}

Метод вернет analyse_id, который потребуется на следующем шаге.

5. Запустите опрос для получения результатов

Раз в секунду отправляйте запрос GET /api/analyses/{{analyse_id}} с полученным ранее analyse_id, пока состояние анализа не изменится с PROCESSING на какое-либо другое. Когда анализ завершится, вы сможете оценить результаты:

• качественные – в resolution (SUCCESS или DECLINED).

• количественные – в results_media[0].results_data.confidence_spoofing. confidence_spoofing; они варьируются от 0.0 до 1.0, где 0.0 означает, что на фото или видео реальный человек, а 1.0 – что система обнаружила спуфинг-атаку.

Коллекция Postman для описанных в статье шагов:

7KB

Oz API Check with No Front End.postman_collection.json

Шаги выше помогут вам выполнить Liveness-проверку через Oz API. Чтобы получить доступ к снятым видео и результатам анализов, воспользуйтесь веб-консолью или API-запросами.

Детальную информацию о том, как применять инструменты Oz API, вы можете найти в руководстве разработчика.