# Как провести проверку медиафайла на 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).
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://doc.ozforensics.com/oz-knowledge-ru/obshaya-informaciya/kratkie-rukovodstva-po-integracii/proverka-liveness-na-servere/kak-provesti-proverku-mediafaila-na-liveness-bez-ispolzovaniya-frontenda-oz.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
