Как провести проверку медиафайла на Liveness без использования фронтенда Oz
PreviousКак интегрировать серверную проверку Liveness в ваше мобильное приложениеNextПроверка Liveness на устройстве
Last updated
Last updated
Oz API – это API для распознавания лиц: как для проверки Liveness, так и для биометрической проверки, то есть сравнения лиц между собой.
Ключевые преимущества Oz API:
Сохранение данных – ваши медиафайлы и анализы хранятся для будущего использования, пока вы самостоятельно их не удалите
Возможность работать и с фото, и с видео
Асинхронность анализов
Безопасная аутентификация
Гибкая настройка уровней доступа
Основная сущность в Oz API – это папка: в папку вы можете загружать медиафайлы, запускать для них анализы и получать результаты не только для отдельных анализов, но и для папки в целом.
Здесь мы приводим пошаговую инструкцию по проведению проверки Liveness для фото или видео лица, которое вы уже сняли с помощью бэкенда Oz.
Создание папки
Загрузка медиафайла в папку
Проверка Liveness
Получение результатов
Для вашего удобства и повышения точности анализов мы рекомендуем использовать для съемки медиа наши Web или Mobile SDK. Как это сделать, описано здесь:
Чтобы начать, вам понадобятся логин и пароль. Напишите нам, и вы отправим вам всю необходимую информацию, включая ссылки:
Логин: ivan_ivanov@yourcompany.com
Пароль: …
API: https://sandbox.ohio.ozforensics.com
Web Console: https://sandbox.ohio.ozforensics.com
Со всеми методами Oz API можно ознакомиться здесь: коллекция Postman.
Мы рекомендуем использовать токен доступа вместо логина и пароля, так как это более безопасно. Вызовите метод POST /api/authorize/auth. В теле запроса укажите логин и пароль
В ответе вам придет токен доступа. В дальнейшем его нужно будет указывать в поле X-Forensic-Access-Token.
Внимание: если вы используете API версии 5.0.0 или новее, пропустите этот шаг.
В версии 4.0.8 и ниже проверка Oz Liveness может производиться либо по видео, либо по последовательности кадров в архиве. Таким образом, если вы хотите запустить проверку по одной фотографии, ее необходимо добавить в ZIP-архив. Oz API будет обрабатывать этот архив так же, как видео. Обратите внимание: теги к этому архиву необходимо указывать из списка тегов для видео.
Чтобы создать папку и добавить в нее ваши фото и видео, вызовите метод POST /api/folders/ и добавьте медиафайлы в тело запроса.
В поле payload укажите следующие теги:
В случае успеха вернется код 201. В ответе будет идентификатор папки folder_id – он понадобится в дальнейшем.
Для запуска анализа вызовите метод POST /api/folders/{{folder_id}}/analyses/ и укажите в нем folder_id из предыдущего шага. В теле запроса укажите анализ Liveness (Quality).
Метод вернет analyse_id, который потребуется на следующем шаге.
Раз в секунду отправляйте запрос 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 для описанных в статье шагов:
Шаги выше помогут вам выполнить Liveness-проверку через Oz API. Чтобы получить доступ к снятым видео и результатам анализов, воспользуйтесь веб-консолью или API-запросами.
Детальную информацию о том, как применять инструменты Oz API, вы можете найти в руководстве разработчика.
