> 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

<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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.