# Как провести проверку медиафайла на Liveness без использования фронтенда Oz
{% hint style="warning" %}
Мы рекомендуем использовать наши продукты в сочетании с Oz Mobile или Web SDK, поскольку наши SDK включают в себя множество важных функций для обеспечения безопасности. Приведённый ниже пример интеграции дан исключительно для ознакомления. Ответственность за возникающие при использовании такой схемы риски лежит на стороне интегратора.
{% endhint %}
Oz API – это API для распознавания лиц: как для проверки Liveness, так и для биометрической проверки, то есть сравнения лиц между собой.
Ключевые преимущества Oz API:
* Сохранение данных – ваши медиафайлы и анализы хранятся для будущего использования, пока вы самостоятельно их не удалите
* Возможность работать и с фото, и с видео
* Асинхронность анализов
* Безопасная аутентификация
* Гибкая настройка уровней доступа
Основная сущность в Oz API – это папка: в папку вы можете загружать медиафайлы, запускать для них анализы и получать результаты не только для отдельных анализов, но и для папки в целом.
Здесь мы приводим пошаговую инструкцию по проведению проверки Liveness для фото или видео лица, которое вы уже сняли с помощью бэкенда Oz.
* Создание папки
* Загрузка медиафайла в папку
* Проверка Liveness
* Получение результатов
Для вашего удобства и повышения точности анализов мы рекомендуем использовать для съемки медиа наши Web или Mobile SDK. Как это сделать, описано здесь:
* [Интеграция Oz Liveness Web SDK](https://doc.ozforensics.com/oz-knowledge-ru/obshaya-informaciya/kratkie-rukovodstva-po-integracii/proverka-liveness-na-servere/kak-integrirovat-servernuyu-proverku-liveness-v-vashe-web-prilozhenie)
* [Интеграция Oz Liveness Mobile SDK](https://app.gitbook.com/o/-MQv6kXBVXmdGRKx4Fy8/s/HLoHbtSPFA1Ul7oKM5SC/~/changes/373/obshaya-informaciya/kratkie-rukovodstva-po-integracii/proverka-liveness-na-servere/kak-integrirovat-servernuyu-proverku-liveness-v-vashe-mobilnoe-prilozhenie)
Чтобы начать, вам понадобятся логин и пароль. Напишите нам, и вы отправим вам всю необходимую информацию, включая ссылки:
Логин:
Пароль: …
API:
Web Console:
Со всеми методами Oz API можно ознакомиться здесь: [коллекция Postman](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/postman#kollekciya-oz-api).
#### 1. Получите токен доступа
Мы рекомендуем использовать токен доступа вместо логина и пароля, так как это более безопасно. Вызовите [метод](https://documenter.getpostman.com/view/23712118/2s93m1Z4bP#36a86a61-5e53-41bb-b760-78690826f494) `POST /api/authorize/auth`. В теле запроса укажите логин и пароль
```json
{
"credentials": {
"email": "", // электронная почта для доступа администратора
"password": "" // полученный от нас пароль
}
}
```
В ответе вам придет токен доступа. В дальнейшем его нужно будет указывать в поле X-Forensic-Access-Token.
#### 2. Поместите отдельные фотографии в архивы (для версии 4.0.8 и ниже)
Внимание: если вы используете API версии 5.0.0 или новее, пропустите этот шаг.
В версии 4.0.8 и ниже проверка Oz Liveness может производиться либо по видео, либо по последовательности кадров в архиве. Таким образом, если вы хотите запустить проверку по одной фотографии, ее необходимо добавить в ZIP-архив. Oz API будет обрабатывать этот архив так же, как видео. Обратите внимание: теги к этому архиву необходимо указывать из [списка тегов для видео](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/media-tags#tegi-videofailov).
#### 3. Загрузите медиафайлы в папку
Чтобы создать папку и добавить в нее ваши фото и видео, вызовите [метод](https://documenter.getpostman.com/view/23712118/2s93m1Z4bP#9d0ae7d6-4059-458c-9404-29fe1c04e226) `POST /api/folders/` и добавьте медиафайлы в тело запроса.
В поле `payload` укажите следующие теги:
```json
{
"media:tags": {
"video1": [
"video_selfie",
"video_selfie_blank",
"orientation_portrait"
],
}
}
```
В случае успеха вернется код 201. В ответе будет идентификатор папки `folder_id` – он понадобится в дальнейшем.
#### 4. Запустите анализ
Для запуска анализа вызовите [метод](https://documenter.getpostman.com/view/23712118/2s93m1Z4bP#92f3494c-affd-45dd-8cbb-60eb19d1d2d9) `POST /api/folders/{{folder_id}}/analyses/` и укажите в нем folder\_id из предыдущего шага. В теле запроса укажите анализ Liveness (Quality).
```json
{
"analyses": [
{
"type": "quality"
}
]
}
```
Метод вернет `analyse_id`, который потребуется на следующем шаге.
#### 5. Запустите опрос для получения результатов
Раз в секунду отправляйте [запрос](https://documenter.getpostman.com/view/23712118/2s93m1Z4bP#3326291e-181e-49e3-80fb-db981d492d13) `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 для описанных в статье шагов:
{% file src="" %}
Шаги выше помогут вам выполнить Liveness-проверку через Oz API. Чтобы получить доступ к снятым видео и результатам анализов, воспользуйтесь [веб-консолью](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-polzovatelya/oz-webui) или API-запросами.
Детальную информацию о том, как применять инструменты Oz API, вы можете найти в [руководстве разработчика](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api).
