# Журнал изменений
#### 6.5.0 – 15.04.2026
* **Нарушение обратной совместимости**: начиная с этой версии, мы больше не поддерживаем Celery.
* **Нарушение обратной совместимости**: параметр `oz_instant_save_artifacts_s3` переименован в `OZ_INSTANT_SAVING_ARTIFACTS_ENABLED`. Если вы использовали этот параметр, переименуйте его вручную.
* Добавили интеграцию с OLAP.
* Улучшили производительность для высокой нагрузки.
* Увеличили общий размер вложений (`OZ_ATTACHMENT_MAX_SIZE`) с 10 до 24 Мбайт.
* Исправили ошибку, из-за которой в ответе на запрос `POST /api/folders/{{folder_id}}/media/request` могли отсутствовать медиафайлы.
* При записи в базу данных теперь используется механизм, обеспечивающий корректные временные метки независимо от используемого часового пояса.
* При повреждении контейнера OzCapsula теперь возвращает конкретные коды ошибок для различных типов повреждений контейнера вместо общего сообщения «Invalid Data Container».
* API в режиме multi-storage теперь работает корректно.
* Исправили ошибку, из-за которой пустая строка как значение параметра `OZ_STATIC_S3_BUCKET_URL` больше не приводит к ошибке конфигурации S3.
* Отправка контейнера без медиафайлов теперь не приводит к ошибке 500.
* Исправили ошибку, из-за которой Instant API мог сохранять артефакты в локальное хранилище даже при отключении соответствующего параметра.
* Исправили ошибку, из-за которой Instant API при обработке некорректного контейнера мог создать запись в базе данных .
* Исправили ошибку с некорректным отображением `time_created` and `time_updated`.
* Повысили безопасность.
#### 6.4.2-18 – 12.02.2026
* **Нарушение обратной совместимости:** чтобы подключение при использовании S3 не пропадало, установите `OZ_STATIC_S3_BUCKET_URL="None"`. Ошибка исправлена в 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
* Добавили новую функциональность: проприетарный формат передачи данных OzCapsula.
* 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 теперь поддерживает новые** [**требования регулятора в Казахстане**](/oz-knowledge-ru/other/obnovlenie-po-v-sootvetstvii-s-novymi-trebovaniyami-regulyatora-v-kazakhstane.md)**:** может извлекать из видеороликов, на которых пользователь делает жесты, кадры с действиями.
* Вы можете убрать права администратора у пользователя с ролью 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**
* Оптимизировали хранилище и базу данных.
* Добавили новый способ отправки данных на анализ: [единый запрос](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/otpravka-na-analiz-edinym-zaprosom.md). Этот запрос включает в себя создание папки и назначение анализов в одном и том же запросе – все необходимые данные указываются в payload.
* Добавили новый режим работы API, при котором данные запроса и ответа не сохраняются ни локально, ни в какой-либо базе данных. [Instant API](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/instant-api-rezhim-raboty-bez-sokhraneniya-dannykh.md) может использоваться и сам по себе, и с другими компонентами 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` как отдельные объекты. Для сохранения одного из кадров вашего видео вы можете воспользоваться опцией "[Лучший кадр](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/use-cases/liveness/best-shot.md)".
* Больше не поддерживаем установку через Podman.
* Обновили методы API: [Oz API 6.0](https://apidoc.ozforensics.com/).
* Заменили параметры и точки входа:
| `PATCH users/{{user_id}}/` для смены пароля | `POST /api/users/{{user_id}}/change-password` |
| -------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `DELETE images\|media/` для удаления фото персоны из коллекции | `DELETE collections//persons//images//` |
| `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
* Оптимизировали потребление серверных ресурсов при проведении биометрического анализа.
#### 5.3.0 – 21.11.2024
* 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
* Обновили коллекцию Postman. Опубликовали новую коллекцию [здесь](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/pages/-MSOBK0raWwPgM-1yqFO#id-5.2) и на .
* Добавили метод проверки настроек таймзоны: `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
* Обновления безопасности.
#### 5.1.0 – 20.03.2024
* Добавили возможность сравнения лица с большой базой фотографий, содержащей миллион фото и более, – Face Identification 1:N.
* Анализ Liveness (QUALITY) теперь игнорирует фото с тегами `photo_id`, `photo_id_front` или `photo_id_back.`
#### 5.0.1 – 16.07.2024
* Обновления безопасности.
#### 5.0.0 – 17.11.2023
* Анализ 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
* Обновления безопасности.
#### 4.0.8 – 22.05.2023
* Настроили авторотацию логов.
* Добавили консольную команду для удаления пользователя.
* Генерацию предпросмотра видео теперь можно отключить.
* Токен доступа для роли ADMIN теперь действителен 5 лет.
* Добавили идентификатор папки `folder_id` к названию отчета.
* Исправили ошибки и оптимизировали работу API.
#### 4.0.2 – 13.09.2022
* Система теперь удаляет ненужные кадры, оставшиеся после раскадровки видео.
* Добавили новые методы GET and POST для media/\/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
* Модули Photo Expert и KYC удалены.
* Обновили конечную точку для изменения пароля пользователя: `POST` users/user\_id/change-password вместо `PATCH`.
#### 3.32.1
* Доступен лог для Celery.
#### 3.32.0
* Добавили в параметры запроса 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
* Добавили новый атрибут для пользователей – `is_active` (по умолчанию True). Если выставлено False, пользователь не может совершать никакие действия.
* Добавили новую ошибку, которая выводится в ответ на попытку заблокированного пользователя что-либо сделать.
#### 3.30.0
* Добавили превью наборов изображений.
* Теперь наборы можно сохранять на диск через атрибуты `original_local_path`, `original_url`.
* Добавили атрибут `original_info` для набора изображений – в нем хранятся сумма md5, размер, mime-тип.
* Исправили отчет для наборов изображений.
#### 3.29.0
* Добавили “проверку здоровья” системы - метод GET `api/healthcheck`. Можно задать перечень имен / очередей задач на проверку активности.
#### 3.28.1
* Поправили ссылку на миниатюру для набора изображений.
#### 3.28.0
* Первое изображение в наборе теперь устанавливается как миниатюра для превью набора.
#### 3.27.0
* Поменяли политики – максимальное количество попыток анализа увеличили до 3 и ввели настраиваемую задержку.
* Поменяли алгоритм вызова `callbacks`.
* Переработали и описали инструменты командной строки.
* Провели рефакторинг модулей.
#### 3.25.0
* Поменяли подметод и метод для удаления персональных данных – с `delete_pi` на `/pi` и с POST на DELETE соответственно.
#### 3.23.1
* Улучшили алгоритм удаления персональных данных.
* В папки, которые были очищены, теперь нельзя добавлять медиа.
#### 3.23.0
* Поменяли название подметода авторизации с `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
* Добавили ошибку, которая появляется при попытке синхронизировать пустые коллекции.
#### 3.22.0
* Добавили параметр `fields_to_check` к анализу документов (по умолчанию проверяет все поля).
* Добавили параметр `double_page_spread` к анализу документов (по умолчанию включен).
#### 3.21.3
* Поправили синхронизацию коллекций.
#### 3.21.0
* Теперь можно продлить токен авторизации с помощью `expire_token`.
#### 3.20.1
* Добавили поддержку application/x-gzip.
#### 3.20.0
* Переименовали shots\_set.images в shots\_set.frames.
#### 3.18.0
* Добавили набор функций по управлению сессиями пользователя.
* Пользователи могут менять владельцев заявок (в соответствии со своими доступами).
* Поменяли правила зависимостей.
* Поправили баг с продлением авторизации.
#### 3.16.0
* Переместили функционал синхронизации коллекций в `oz_core`.
#### 3.15.3
* Упростили работу с наборами изображений. Один набор – один архив.
#### 3.15.2
* Улучшено распознавание документов для Dockered-версии.
#### 3.15.1
* Переместили проверку тега ориентации в анализ Quality.
#### 3.15.0
* Добавили шаблон отчета по умолчанию для ролей Admin и Operator.
#### 3.14.0
* Обновили биометрическую модель.
#### 3.13.2
* Исправили ошибку с созданием объекта набора изображений без изображений.
* Добавили новый формат обмена данными для модуля распознавания документов.
#### 3.13.1
* Если для персон в коллекции проводились какие-либо анализы, коллекцию теперь нельзя удалить.
#### 3.13.0
* Добавили к анализам временные метки `time_task_send_to_broker`, `time_task_received`, `time_task_finished`.
#### 3.12.0
* Добавили новый механизм авторизации – соединение с Active Directory через LDAP.
#### 3.11.0
* Добавили новый тип медиа в заявку: "shots\_set"
* Персону в коллекции теперь нельзя удалить, если с ней производились какие-либо анализы.
#### 3.10.
* Переименовали поле заявки **resolution\_suggest** в **operator\_status**.
* Добавили к заявке текстовое поле **operator\_comment**.
* Доступ на редактирование полей заявки **operator\_status** и **operator\_comment** есть у Admin, Operator, Client Service, Client Operator и Client Admin.
* Доступ на удаление заявки, медиа из заявки, шаблонов отчетов и их вложений, самих отчетов и анализов теперь есть только у Admin и Client Admin (в рамках компании).
#### 3.9.0:
* Исправили удаление отчетов – теперь они удаляются при удалении их автора.
#### 3.8.1
* Поправили доступы – Client теперь может просматривать только свой профиль.
#### 3.8.0
* Client Operator теперь может редактировать только свой профиль.
* Client больше не может удалять свои заявки, любые медиа, отчеты или анализы.
* Client Service может создавать персон в коллекциях и просматривать отчеты в рамках компании.
#### 3.7.1
* У ролей Client, Client Admin, Client Operator теперь есть доступы на просмотр профилей пользователя только внутри компании.
* Запустили альфа/бета-тестирование.
* Теперь поддерживаем заголовок с датой просрочки токена авторизации.
* Добавили поддержку модуля распознавания документов для стенделона и Docker.
#### 3.7.0
* Добавили роль Client Operator – это Client Admin, но без доступа к управлению аккаунтом и компанией.
* И Client Admin, и Client Operator могут менять статус анализа.
* Создавать, редактировать и удалять что-либо в моделях Collection и CollectionPerson в рамках компании теперь могут только Admin и Client Admin.
* При создании отчета по заявке теперь проверяются доступы пользователя к шаблонам.
* Поправили код статуса, который возвращается при создании коллекции, с 200 на 201.
---
# 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/zhurnal-izmenenii.md?ask=
```
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.