> For the complete documentation index, see [llms.txt](https://doc.ozforensics.com/oz-knowledge-ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/statuses.md).

# Статусы API

В данном разделе описаны все возможные статусы анализов в API.

<table><thead><tr><th width="240">Имя поля / статус</th><th>analyses.state</th><th>analyses.resolution_status</th><th width="170">folder.resolution_status</th><th>system_resolution</th></tr></thead><tbody><tr><td>INITIAL</td><td>-</td><td>-</td><td>начальное состояние</td><td>начальное состояние</td></tr><tr><td>FAILED</td><td>ошибка системы</td><td>ошибка системы</td><td>ошибка системы</td><td>ошибка системы</td></tr><tr><td>FINISHED</td><td>успешное завершение</td><td>-</td><td>успешное завершение</td><td></td></tr><tr><td>DECLINED</td><td>-</td><td>отрицательный анализ</td><td>-</td><td>отрицательный анализ</td></tr><tr><td>OPERATOR_REQUIRED</td><td>-</td><td>требуется перепроверка</td><td>-</td><td>требуется перепроверка</td></tr><tr><td>SUCCESS</td><td>-</td><td>положительный анализ</td><td>-</td><td>положительный анализ</td></tr></tbody></table>

Ниже приведены разъяснения по каждому статусу.

## Состояние анализа (`analyses.state`)

Состояние выполнения анализа принимает следующие значения:

`FAILED` – анализ выполнить не удалось, произошла ошибка;

`FINISHED` – выполнение анализа завершено.

## Результат анализа (`analyses.resolution_status`)

Если выполнение анализа завершено, результат выполнения может принимать следующие значения:

`SUCCESS` – проверка пройдена успешно;

`OPERATOR_REQUIRED` (кроме анализа Liveness) – требуется [оператор](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/user-roles.md) (т.е. дополнительная проверка человеком);

{% hint style="info" %}
Наличие/отсутствие статуса `OPERATOR_REQUIRED` зависит от настроек биометрии.
{% endhint %}

`DECLINED` – проверка не пройдена (лицо не совпало или совпало с лицом из ЧС в зависимости от настроек, атака, лицо не совпало с лицом в документах).

Если анализ не завершен, результат наследует значение из `analyses.state`.

## Состояние заявки (`folder.resolution_status`)

Заявка – это папка, в которой лежат медиафайлы для анализа. Если анализы еще не завершены, в `resolution_status` вы увидите одно из следующих значений:

`INITIAL` – анализы не назначены;

`FAILED` – выполнить анализы не удалось (произошли ошибки);&#x20;

`FINISHED` – папка обработана, выполнение анализов завершено.

## Результат заявки (`system_resolution`) <a href="#sostoyanie-zayavki-folder.resolution_status" id="sostoyanie-zayavki-folder.resolution_status"></a>

Результат заявки – консолидированный результат всех анализов, назначенных для медиафайлов из этой папки. Обратите внимание: результат заявки представляет собой результат группы анализов, завершившейся последней. Если все назначенные анализы выполнены, результат будет:

`SUCCESS` – все хорошо, проверки пройдены успешно;

`OPERATOR_REQUIRED` (кроме анализа Liveness) – анализы со статусом `DECLINED` отсутствуют, но один или больше анализов завершились со статусом `OPERATOR_REQUIRED`;

`DECLINED` – один или больше анализов завершились с результатом `DECLINED`, то есть проверка не прошла.

{% hint style="info" %}
Анализы, которые вы отправляете в одном `POST`-запросе, объединяются в группу. Результат группы анализов определяется по "худшему" из результатов анализов в этой группе: `INITIAL` > `FAILED` > `DECLINED` > `OPERATOR_REQUIRED` > `SUCCESS`, где `SUCCESS` означает, что все проверки прошли успешно без каких-либо ошибок.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/statuses.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.