# Liveness

Алгоритм определения живости предназначен для проверки наличия живого человека по короткому видео фрагменту.

Порядок действий:

1. [Авторизуйтесь](https://apidoc.ozforensics.com/#tag/Authorization).
2. [Поместите медиафайл в папку](https://apidoc.ozforensics.com/#tag/Folders/paths/~1api~1folders/post).

{% code title="payload" %}

```javascript
{
  "media:tags": {
    "video1": [
      "video_selfie",
      "video_selfie_scan",
      "orientation_portrait"
    ]
  }
}
```

{% endcode %}

3\. [Запустите анализ](https://apidoc.ozforensics.com/#tag/Analyses/paths/~1api~1folders~1{folder_id}~1analyses/post). 

{% code title="request body" %}

```javascript
{
  "analyses": [{
    "type": "quality",
    "source_media": ["6187a4ef-62c4-4445-bbb2-bf62d61f1fde"],
  }]
}
```

{% endcode %}

В `source_media` указывается `media_id` из ответа предыдущего запроса. Это опционально, если требуется проверить одно из двух заранее загруженных в папку видео.

Сохраните `analyse_id` из ответа.

4а. Через некоторое время [проверьте результат](https://apidoc.ozforensics.com/#tag/Analyses/paths/~1api~1analyses~1{analyse_id}/get). 

Дождитесь, когда поля `resolution_status` и `resolution` изменят статус на любой, кроме `PROCESSING`, – этот статус и будет результатом. 

4б.  Еще один вариант: добавьте [вебхук](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/autentifikaciya-i-obrabotka-dannykh/ispolzovanie-vebkhukov-dlya-polucheniya-rezultatov), который обратится к вашему сайту по завершении анализа. В payload запроса добавьте нужный адрес в поле `resolution_endpoint`:

```javascript
{    
    "resolution_endpoint": "address.com",
    {
    .... // информация о папке и т.д.
    }
}
```

В запросе вебхука будет содержаться информация о папке и связанных с ней анализах.

Подробно статусы анализов описаны [здесь](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/statuses).