# Журнал изменений

#### 6.5.0 – 15.04.2026

* <mark style="background-color:$warning;">**Нарушение обратной совместимости**</mark><mark style="background-color:$warning;">: начиная с этой версии, мы больше не поддерживаем Celery.</mark>
* <mark style="background-color:$warning;">**Нарушение обратной совместимости**</mark><mark style="background-color:$warning;">: параметр</mark> <mark style="background-color:$warning;"></mark><mark style="background-color:$warning;">`oz_instant_save_artifacts_s3`</mark> <mark style="background-color:$warning;"></mark><mark style="background-color:$warning;">переименован в</mark> <mark style="background-color:$warning;"></mark><mark style="background-color:$warning;">`OZ_INSTANT_SAVING_ARTIFACTS_ENABLED`</mark><mark style="background-color:$warning;">. Если вы использовали этот параметр, переименуйте его вручную.</mark>
* Добавили интеграцию с OLAP.
* Улучшили производительность для высокой нагрузки.&#x20;
* Увеличили общий размер вложений (`OZ_ATTACHMENT_MAX_SIZE`) с 10 до 24 Мбайт.
* Исправили ошибку, из-за которой в ответе на запрос `POST /api/folders/{{folder_id}}/media/request` могли отсутствовать медиафайлы.
* При записи в базу данных теперь используется механизм, обеспечивающий корректные временные метки независимо от используемого часового пояса.
* При повреждении контейнера OzCapsula теперь возвращает конкретные коды ошибок для различных типов повреждений контейнера вместо общего сообщения «Invalid Data Container».&#x20;
* API в режиме multi-storage теперь работает корректно.&#x20;
* Исправили ошибку, из-за которой пустая строка как значение параметра `OZ_STATIC_S3_BUCKET_URL` больше не приводит к ошибке конфигурации S3.
* Отправка контейнера без медиафайлов теперь не приводит к ошибке 500.&#x20;
* Исправили ошибку, из-за которой Instant API мог сохранять артефакты в локальное хранилище даже при отключении соответствующего параметра.&#x20;
* Исправили ошибку, из-за которой Instant API при обработке некорректного контейнера мог создать запись в базе данных .
* Исправили ошибку с некорректным отображением `time_created` and `time_updated`.
* Повысили безопасность.

#### 6.4.2-18 – 12.02.2026

* <mark style="background-color:$warning;">**Нарушение обратной совместимости:**</mark> <mark style="background-color:$warning;"></mark><mark style="background-color:$warning;">чтобы подключение при использовании S3 не пропадало, установите</mark> <mark style="background-color:$warning;"></mark><mark style="background-color:$warning;">`OZ_STATIC_S3_BUCKET_URL="None"`</mark><mark style="background-color:$warning;">.</mark> Ошибка исправлена в 6.5.0.
* Контейнер теперь можно отправить в уже существующую папку. Используйте метод `POST api/folders/{folder_id}/media`.
* Повысили производительность анализа **Collection**.
* Слишком длинные видео теперь можно обрезать. Установите параметру `OZ_FFMPEG_VIDEO_CROPPING_ENABLED` значению `true`  для автоматической обрезки всех видео длиннее `OZ_VIDEO_DURATION_MAX`. Записи об обрезке сохраняются в логах.
* При невозможности обработки контейнера (ошибка 14) для упрощения расследования мы теперь сохраняем и данные соответствующей заявки.
* Для невалидных контейнеров, чтобы удобнее было искать информацию, теперь сохраняем в логах API `folder_id`.
* При удалении папки в конфгурациях local-local и local-s3 файлы статики теперь удаляются корректно.

#### 6.4.1-40 – 24.12.2025

* <mark style="background-color:$primary;">Добавили новую функциональность: проприетарный формат передачи данных OzCapsula.</mark>
* Instant API теперь может сохранять статику и JSON payload в S3. Чтобы включить возможность сохранения, установите параметру `oz_instant_save_artifacts_s3` значение `true`.
* Исправлена проблема с периодическими ложными отказами при использовании медиа, полученных из Web SDK.
* Анализ `Collection` теперь игнорирует изображения с тегом `photo_id_back`.
* Внесены внутренние улучшения.

#### **6.4.0 – 24.11.2025**

{% hint style="info" %}
Только для SaaS.
{% endhint %}

* Обновили API в рамках подготовки к внедрению новой функциональности.

#### **6.3.5 – 03.11.2025**

* Исправили ошибки, из-за которых по запросу `GET /api/folders/` могли возвращаться некорректные результаты.

#### **6.3.4 – 20.10.2025**

* Обновили API в рамках подготовки к внедрению новой функциональности.
* Исправили ошибки.

#### **6.3.3 – 29.09.2025**

* Исправили ошибку, из-за которой при отправке поврежденного видео с помощью методов `POST /api/instant/folders/` и `POST /api/folders/` система возвращала “500 Internal Server Error”. Теперь возвращается “400 Bad Request”.
* Обновили API в рамках подготовки к внедрению новой функциональности.

#### **6.3.0 – 05.08.2025**

* **API 6 теперь поддерживает новые** [**требования регулятора в Казахстане**](https://doc.ozforensics.com/oz-knowledge-ru/other/obnovlenie-po-v-sootvetstvii-s-novymi-trebovaniyami-regulyatora-v-kazakhstane)**:** может извлекать из видеороликов, на которых пользователь делает жесты, кадры с действиями.
* Вы можете убрать права администратора у пользователя с ролью CLIENT ADMIN, изменив его роль на CLIENT с помощью метода `PATCH /api/users/{{user_id}}`.
* Теперь вы можете создать сервисный токен для пользователя с ролью OPERATOR.
* Повысили безопасность.

#### **6.2.5 – 18.06.25**

* Оптимизировали API и улучшили его производительность.

#### **6.2.3 – 02.06.25**

* Анализы теперь могут выполняться параллельно друг другу. Для включения опции установите значение `true` параметру `OZ_ANALYSE_PARALLELED_CHECK_MEDIA_ENABLED` в файле `config.py` (значение по умолчанию – `false`).
* Вы можете выключить авторизацию для Instant API (режима работы без сохранения данных). Добавьте в файл конфигурации `config.py` параметр `OZ_AUTHORIZE_DISABLED_STATELESS` и установите ему значение `true` (значение по умолчанию – `false`).
* Исправили ошибку, из-за которой видео в MP4 могло не проигрываться после скачивания из SDK.
* Для запросов без авторизации теперь возвращается корректная ошибка.
* Исправили ошибку, из-за которой временами появлялась ошибка 500. Это происходило, если в видео было слишком мало кадров. Добавили соответствующую проверку и сделали описания ошибок более информативными.
* Улучшили производительность, сделали удобнее процесс установки, повысили безопасность.

#### **6.0.1 – 30.04.25**

* Оптимизировали хранилище и базу данных.
* Добавили новый способ отправки данных на анализ: [единый запрос](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/otpravka-na-analiz-edinym-zaprosom). Этот запрос включает в себя создание папки и назначение анализов в одном и том же запросе – все необходимые данные указываются в payload.
* Добавили новый режим работы API, при котором данные запроса и ответа не сохраняются ни локально, ни в какой-либо базе данных. [Instant API](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/instant-api-rezhim-raboty-bez-sokhraneniya-dannykh) может использоваться и сам по себе, и с другими компонентами API.
* Теперь можно комбинировать рабочие системы, использующие асинхронные методы или Celery worker (локальная обработка, обработка через Celery). Для каждой из комбинаций добавлена поддержка хранения в S3.
* Повысили безопасность.
* Прекратили поддержку RAR-архивов.
* Временно не поддерживаем Active Directory. В будущих релизах планируем вернуть эту функциональность.
* Длительность анализа теперь считается точнее.
* Для роли CLIENT заменили флаги `is_admin` и `is_service` новыми ролями: CLIENT ADMIN и CLIENT SERVICE соответственно. Для установки роли воспользуйтесь параметром `user_type`.
* Чтобы выписать сервисный токен для пользователя с помощью метода `{{host}}/api/authorize/service_token/`, убедитесь, что этому пользователю назначена роль CLIENT SERVICE. Токен для другого пользователя с такой ролью можно создать с помощью `{{host}}/api/authorize/service_token/{user_id}`.
* Убрали атрибуты коллекции и персоны из `COLLECTION.analysis`.
* Мы больше не записываем кадры в `SHOTS_SET` как отдельные объекты. Для сохранения одного из кадров вашего видео вы можете воспользоваться опцией "[Лучший кадр](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/use-cases/liveness/best-shot)".
* Больше не поддерживаем установку через Podman.
* Обновили методы API: [Oz API 6.0](https://apidoc.ozforensics.com/).
* Заменили параметры и точки входа:

| `PATCH users/{{user_id}}/` для смены пароля                                      | `POST /api/users/{{user_id}}/change-password`                               |
| -------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `DELETE images\|media/<media_id>` для удаления фото персоны из коллекции         | `DELETE collections/<collection_id>/persons/<person_id>/images/<media_id>/` |
| `image_id`, `video_id` и `shots_set_id`                                          | `media_id`                                                                  |
| `analyse_id`                                                                     | `analysis_id`                                                               |
| `can_start_analyse_biometry`                                                     | `can_start_analysis_biometry`                                               |
| `can_start_analyse_collection`                                                   | `can_start_analysis_collection`                                             |
| `can_start_analyse_documents`                                                    | `can_start_analysis_documents`                                              |
| `can_start_analyse_quality`                                                      | `can_start_analysis_quality`                                                |
| `expire_date` в `{{host}}/api/authorize/auth` и `{{host}}/api/authorize/refresh` | `access_token.exp` из payload                                               |
| `session_id` в `{{host}}/api/authorize/auth` и `{{host}}/api/authorize/refresh`  | `token_id`                                                                  |

#### 5.3.1 – 24.12.2024 <a href="#h.lit7e6vfzfmh" id="h.lit7e6vfzfmh"></a>

* Оптимизировали потребление серверных ресурсов при проведении биометрического анализа.

#### 5.3.0 – 21.11.2024 <a href="#h.lit7e6vfzfmh" id="h.lit7e6vfzfmh"></a>

* API теперь может извлекать из видеороликов, на которых пользователь делает жесты, кадры с действиями. Доработка выполнена в связи с вводом новых регуляторных требований к биометрической идентификации в Казахстане. Требования к версиям других компонентов описаны [здесь](https://doc.ozforensics.com/oz-knowledge-ru/other/obnovlenie-po-v-sootvetstvii-s-novymi-trebovaniyami-regulyatora-v-kazakhstane).
* Подготовили новый шаблон отчета, который также соответствует этим требованиям.
* Миниатюры для нового отчета генерируются на основе кадров с действиями.

#### 5.2.0 – 06.09.2024 <a href="#h.lit7e6vfzfmh" id="h.lit7e6vfzfmh"></a>

* Обновили коллекцию Postman. Опубликовали новую коллекцию [здесь](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/postman#id-5.2) и на <https://apidoc.ozforensics.com/>.
* Добавили метод проверки настроек таймзоны: `GET {{host}}/api/config`
* Добавили параметры к методу `GET {{host}}/api/event_sessions`:
  * `time_created`
  * `time_created.min`
  * `time_created.max`
  * `time_updated`
  * `time_updated.min`
  * `time_updated.max`
  * `session_id`
  * `session_id.exclude`
  * `sorting`
  * `offset`
  * `limit`
  * `total_omit`
* При создании папки с SHOT\_SET соответствующее видео будет в `media.video_url`.
* Исправили ошибку, из-за которой CLIENT ADMIN не мог установить новый пароль для пользователя из своей компании.

#### 5.1.1 – 16.07.2024 <a href="#h.lit7e6vfzfmh" id="h.lit7e6vfzfmh"></a>

* Обновления безопасности.

#### 5.1.0 – 20.03.2024 <a href="#h.lit7e6vfzfmh" id="h.lit7e6vfzfmh"></a>

* Добавили возможность сравнения лица с большой базой фотографий, содержащей миллион фото и более, – Face Identification 1:N.
* Анализ Liveness (QUALITY) теперь игнорирует фото с тегами `photo_id`, `photo_id_front` или `photo_id_back.`

#### 5.0.1 – 16.07.2024 <a href="#h.lit7e6vfzfmh" id="h.lit7e6vfzfmh"></a>

* Обновления безопасности.

#### 5.0.0 – 17.11.2023 <a href="#h.lit7e6vfzfmh" id="h.lit7e6vfzfmh"></a>

* Анализ Liveness (QUALITY) теперь работает и с изображениями.
* Исправили ошибку, из-за которой анализ Liveness мог завершиться с успехом при отсутствии медиафайлов в папке (заявке).
* Для `extract_best_shot` изменили значение по умолчанию на `True`.
* Архивы RAR больше не поддерживаются.
* По умолчанию в `analyses.results_media.results_data` теперь один параметр: `confidence_spoofing`. Если для обратной совместимости нужны все три (`confidence_replay`, `confidence_liveness` и `confidence_spoofing`), это можно настроить.
* Обновили PDF-отчет, который грузится по умолчанию.
* Название PDF-отчета теперь содержит `folder_id`.

#### 4.0.8-patch1 – 16.07.2024 <a href="#h.lit7e6vfzfmh" id="h.lit7e6vfzfmh"></a>

* Обновления безопасности.

#### 4.0.8 – 22.05.2023 <a href="#h.lit7e6vfzfmh" id="h.lit7e6vfzfmh"></a>

* Настроили авторотацию логов.
* Добавили консольную команду для удаления пользователя.
* Генерацию предпросмотра видео теперь можно отключить.
* Токен доступа для роли ADMIN теперь действителен 5 лет.
* Добавили идентификатор папки `folder_id` к названию отчета.
* Исправили ошибки и оптимизировали работу API.

#### 4.0.2 – 13.09.2022 <a href="#h.lit7e6vfzfmh" id="h.lit7e6vfzfmh"></a>

* Система теперь удаляет ненужные кадры, оставшиеся после раскадровки видео.
* Добавили новые методы GET and POST для media/\<media\_id>/snapshot/
* Заменили шаблон отчета по умолчанию.
* Превью для набора кадров теперь показывается с исходным соотношением сторон.
* ADMIN и OPERATOR автоматически добавляются в system\_company.
* Для User, Folder, Analyse, Media добавили атрибут `company_id`.
* Для Analysis добавили атрибут `group_id`.
* Для Folder и Analysis добавили атрибут `system_resolution`.
* `resolution_status` теперь возвращает значение `system_resolution`.
* Убрали метод PATCH для коллекций.
* Добавили фильтр по `resolution_status` для Folder Analyses \[LIST] и по `analyse.resolution_status` для Folder \[LIST].
* Для Folder, User, Company добавили журналирование.
* Обновили алгоритм удаления компании.
* Улучшили логику обработки черных списков.
* Исправили несколько багов.

#### 3.33.0 <a href="#h.lit7e6vfzfmh" id="h.lit7e6vfzfmh"></a>

* Модули Photo Expert и KYC удалены.
* Обновили конечную точку для изменения пароля пользователя: `POST` users/user\_id/change-password вместо `PATCH`.

#### 3.32.1 <a href="#h.lit7e6vfzfmh" id="h.lit7e6vfzfmh"></a>

* Доступен лог для Celery.

#### 3.32.0 <a href="#h.lit7e6vfzfmh" id="h.lit7e6vfzfmh"></a>

* Добавили в параметры запроса Folder \[LIST] фильтры: `analyse.time_created`, `analyse.results_data` для анализа Documents, `results_data` для анализа Biometry, `results_media_results_data` для анализа QUALITY. Для включения фильтра установите `True` в параметре запроса `with_results_media_filter`.

#### 3.31.0 <a href="#h.uoqa4laizfrg" id="h.uoqa4laizfrg"></a>

* Добавили новый атрибут для пользователей – `is_active` (по умолчанию True). Если выставлено False, пользователь не может совершать никакие действия.
* Добавили новую ошибку, которая выводится в ответ на попытку заблокированного пользователя что-либо сделать.

#### 3.30.0 <a href="#h.5ggraxc9ir3f" id="h.5ggraxc9ir3f"></a>

* Добавили превью наборов изображений.
* Теперь наборы можно сохранять на диск через атрибуты `original_local_path`, `original_url`.
* Добавили атрибут `original_info` для набора изображений – в нем хранятся сумма md5, размер, mime-тип.
* Исправили отчет для наборов изображений.

#### 3.29.0 <a href="#h.h23b188g5otd" id="h.h23b188g5otd"></a>

* Добавили “проверку здоровья” системы - метод GET `api/healthcheck`. Можно задать перечень имен / очередей задач на проверку активности.

#### 3.28.1 <a href="#h.l6rt2kmrwxmf" id="h.l6rt2kmrwxmf"></a>

* Поправили ссылку на миниатюру для набора изображений.

#### 3.28.0 <a href="#h.94gb8z8joaw" id="h.94gb8z8joaw"></a>

* Первое изображение в наборе теперь устанавливается как миниатюра для превью набора.

#### 3.27.0 <a href="#h.ahiuf1v9bxx5" id="h.ahiuf1v9bxx5"></a>

* Поменяли политики – максимальное количество попыток анализа увеличили до 3 и ввели настраиваемую задержку.
* Поменяли алгоритм вызова `callbacks`.
* Переработали и описали инструменты командной строки.
* Провели рефакторинг модулей.

#### 3.25.0 <a href="#h.5yncxfncaqex" id="h.5yncxfncaqex"></a>

* Поменяли подметод и метод для удаления персональных данных – с `delete_pi` на `/pi` и с POST на DELETE соответственно.

#### 3.23.1 <a href="#h.1j00qjckn9qt" id="h.1j00qjckn9qt"></a>

* Улучшили алгоритм удаления персональных данных.
* В папки, которые были очищены, теперь нельзя добавлять медиа.

#### 3.23.0 <a href="#h.i2u27bcx2kj" id="h.i2u27bcx2kj"></a>

* Поменяли название подметода авторизации с `auth` на `auth_restore`.
* Добавили тег video\_selfie\_oneshot.
* Добавили настройки валидации пароля.
* Добавили задержки для `auth`, `rest_unauthorized`, `rps_with_token` (`OZ_THROTTLING_RATES` в настройках, по умолчанию отключено).
* Теперь можно проверять доступы пользователя к статичным файлам (`OZ_USE_PERMISSIONS_FOR_STATIC` в настройках, по умолчанию – False).
* Добавили новый подметод для заявки - `/delete_pi`. С его помощью можно удалить в заявке все персональные данные и связанные с ними анализы.

#### 3.22.2 <a href="#h.fk44qbh2v8f7" id="h.fk44qbh2v8f7"></a>

* Добавили ошибку, которая появляется при попытке синхронизировать пустые коллекции.

#### 3.22.0 <a href="#h.h5hn30m5bunv" id="h.h5hn30m5bunv"></a>

* Добавили параметр `fields_to_check` к анализу документов (по умолчанию проверяет все поля).
* Добавили параметр `double_page_spread` к анализу документов (по умолчанию включен).

#### 3.21.3 <a href="#h.6730cuizq7xr" id="h.6730cuizq7xr"></a>

* Поправили синхронизацию коллекций.

#### 3.21.0 <a href="#h.sk53eeytmuoe" id="h.sk53eeytmuoe"></a>

* Теперь можно продлить токен авторизации с помощью `expire_token`.

#### 3.20.1 <a href="#h.phzvtvto4r05" id="h.phzvtvto4r05"></a>

* Добавили поддержку application/x-gzip.

#### 3.20.0 <a href="#h.x3yr1fy1jj3s" id="h.x3yr1fy1jj3s"></a>

* Переименовали shots\_set.images в shots\_set.frames.

#### 3.18.0 <a href="#h.b6ac0ix8a9cj" id="h.b6ac0ix8a9cj"></a>

* Добавили набор функций по управлению сессиями пользователя.
* Пользователи могут менять владельцев заявок (в соответствии со своими доступами).
* Поменяли правила зависимостей.
* Поправили баг с продлением авторизации.

#### 3.16.0 <a href="#h.cu7h9k4a2cij" id="h.cu7h9k4a2cij"></a>

* Переместили функционал синхронизации коллекций в `oz_core`.

#### 3.15.3 <a href="#h.h11h56kjwcgo" id="h.h11h56kjwcgo"></a>

* Упростили работу с наборами изображений. Один набор – один архив.

#### 3.15.2 <a href="#h.mhsirzihd65b" id="h.mhsirzihd65b"></a>

* Улучшено распознавание документов для Dockered-версии.

#### 3.15.1 <a href="#h.6e8c9mt83jx4" id="h.6e8c9mt83jx4"></a>

* Переместили проверку тега ориентации в анализ Quality.

#### 3.15.0 <a href="#h.6qusq0bkytjk" id="h.6qusq0bkytjk"></a>

* Добавили шаблон отчета по умолчанию для ролей Admin и Operator.

#### 3.14.0 <a href="#h.jacsqpr8d6e1" id="h.jacsqpr8d6e1"></a>

* Обновили биометрическую модель.

#### 3.13.2 <a href="#h.lwy816mdwaqb" id="h.lwy816mdwaqb"></a>

* Исправили ошибку с созданием объекта набора изображений без изображений.
* Добавили новый формат обмена данными для модуля распознавания документов.

#### 3.13.1 <a href="#h.mpj2f8k8m71f" id="h.mpj2f8k8m71f"></a>

* Если для персон в коллекции проводились какие-либо анализы, коллекцию теперь нельзя удалить.

#### 3.13.0 <a href="#h.wj0kopo1tf2g" id="h.wj0kopo1tf2g"></a>

* Добавили к анализам временные метки `time_task_send_to_broker`, `time_task_received`, `time_task_finished`.

#### 3.12.0 <a href="#h.eejm0hop92g3" id="h.eejm0hop92g3"></a>

* Добавили новый механизм авторизации – соединение с Active Directory через LDAP.

#### 3.11.0 <a href="#h.1948pv993kxx" id="h.1948pv993kxx"></a>

* Добавили новый тип медиа в заявку: "shots\_set"
* Персону в коллекции теперь нельзя удалить, если с ней производились какие-либо анализы.

#### 3.10. <a href="#h.8ruawe39eh1z" id="h.8ruawe39eh1z"></a>

* Переименовали поле заявки **resolution\_suggest** в **operator\_status**.
* Добавили к заявке текстовое поле **operator\_comment**.
* Доступ на редактирование полей заявки **operator\_status** и **operator\_comment** есть у Admin, Operator, Client Service, Client Operator и Client Admin.
* Доступ на удаление заявки, медиа из заявки, шаблонов отчетов и их вложений, самих отчетов и анализов теперь есть только у Admin и Client Admin (в рамках компании).

#### 3.9.0: <a href="#h.v6iqfvzde77y" id="h.v6iqfvzde77y"></a>

* Исправили удаление отчетов – теперь они удаляются при удалении их автора.

#### 3.8.1 <a href="#h.ie9ai8gsb9va" id="h.ie9ai8gsb9va"></a>

* Поправили доступы – Client теперь может просматривать только свой профиль.

#### 3.8.0 <a href="#h.lnr8ph7jrqdl" id="h.lnr8ph7jrqdl"></a>

* Client Operator теперь может редактировать только свой профиль.
* Client больше не может удалять свои заявки, любые медиа, отчеты или анализы.
* Client Service может создавать персон в коллекциях и просматривать отчеты в рамках компании.

#### 3.7.1 <a href="#h.dbqh79jld72o" id="h.dbqh79jld72o"></a>

* У ролей Client, Client Admin, Client Operator теперь есть доступы на просмотр профилей пользователя только внутри компании.
* Запустили альфа/бета-тестирование.
* Теперь поддерживаем заголовок с датой просрочки токена авторизации.
* Добавили поддержку модуля распознавания документов для стенделона и Docker.

#### 3.7.0 <a href="#h.fs7jx3pcwvcc" id="h.fs7jx3pcwvcc"></a>

* Добавили роль Client Operator – это Client Admin, но без доступа к управлению аккаунтом и компанией.
* И Client Admin, и Client Operator могут менять статус анализа.
* Создавать, редактировать и удалять что-либо в моделях Collection и CollectionPerson в рамках компании теперь могут только Admin и Client Admin.
* При создании отчета по заявке теперь проверяются доступы пользователя к шаблонам.
* Поправили код статуса, который возвращается при создании коллекции, с 200 на 201.