# Статусы API

<table><thead><tr><th width="240">Имя поля / статус</th><th>analyse.state</th><th>analyse.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>PROCESSING</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>

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

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

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

`PROCESSING` – в обработке;

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

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

## Результат анализа (analyse.resolution\_status)

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

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

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

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

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

Если анализ не завершен, результат наследует значение из `analyse.state`: `PROCESSING` (еще в обработке) / `FAILED` (возникли ошибки, завершить анализ не удалось).

## Состояние заявки (folder.resolution\_status)

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

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

`PROCESSING` – анализы выполняются;

`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` > `PROCESSING` > `FAILED` > `DECLINED` > `OPERATOR_REQUIRED` > `SUCCESS`, где `SUCCESS` означает, что все проверки прошли успешно без каких-либо ошибок.
{% endhint %}


---

# 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/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/statuses.md?ask=<question>
```

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.