> 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/zhurnal-izmenenii.md).
# Журнал изменений
#### 6.6.2 – 24.06.2026
* Реализовано отслеживание транзакций для поддержки биллинга on-premises клиентов (Instant API).
* Оптимизирована производительность для `GET /api/folders/`, `GET /api/folders/{folder_id}/media/` и `GET /api/folders/{folder_id}/analyses/`.
* Расширен сбор логов для OLAP.
* `/api/authorize/session_token/` теперь поддерживает `POST` вместе с `GET`.
* TFSS теперь эффективнее использует ресурсы.
* Улучшена производительность биометрического анализа: повышение до 16% для одного жеста и до 39% для нескольких жестов.
* В `GET /api/authorize/session_token/` добавлен опциональный заголовок `X-Forensic-Company-Id`. В мультитенантных развертываниях Instant API используйте этот заголовок для передачи `company_id` тенанта (UUID) при получении session token. Значение встраивается в токен и используется для определения принадлежности транзакций в биллинге и аналитике.
* `media_association_id` в `output_images` для `best_shot` и `action_shot` теперь корректно отражает идентификатор медиафайла, из которого был извлечен кадр.
* `preview_url` для видеомедиа теперь содержит суффикс `_preview`, как и у shotset.
#### 6.6.1 – 09.06.2026
* API теперь может обрабатывать контейнер OzCapsula с другими контейнерами OzCapsula внутри. Функциональность предусмотрена только для интеграции с мобильными SDK.
* Добавили поддержку OpenTelemetry.
* Для анализа Liveness теперь можно извлечь полноразмерный кадр с жестом пользователя: в payload запроса установите `extract_action_shot` значение `1` или `true`. В ответе API найдите `analyses[].results_media[].output_images[]`. Название кадра с жестом: `original_name` = `ResultImageActionShot.jpeg`. Шаблон отчета по умолчанию также обновили, он включен в образ API.
* Оптимизировали обработку shotset.
* Теперь вы можете снизить нагрузку на TFSS, установив ограничение на количество запросов, которые API одновременно туда отправляет. Используйте настройку `OZ_SERVICE_TFSS_CONCURRENCY_LIMIT_MODE`, как описано [здесь](/oz-knowledge-ru/rukovodstva/rukovodstvo-administratora/configuration.md#taimingi-i-ogranicheniya).
* Лучший кадр в формате base64 теперь по умолчанию присутствует в ответе API. Его можно найти в `analyses[].results_media[].output_images[].image_b64`.
* Ответы API для запросов с контейнером теперь содержат раздел `analyses[]`, даже если запрос был отклонен с не равным `null` `decline_reason`. Соответствующие интеграции, например, колбэк `on_complete` в Web SDK, теперь функционируют корректно.
* Установленная в API тайм-зона больше не влияет на `expire_date` в ответе `/api/authorize/auth` .
* Теперь все ошибки OzCapsula по умолчанию возвращают текст "Invalid request data". Коды ошибок не изменились.
* При использовании S3 мы теперь сохраняем несколько файлов `engine_response.json` для каждого медиа – по числу анализов (именование: `{analysis_id}_{source_media_id}_engine_response.json`).
* Запрос `GET /api/collections/{collection_id}/persons/` больше не возвращает ошибку `500 Internal Server Error` для старых форматов пути к изображению. Для неправильного пути отображается информативная ошибка.
* При ошибке сериализации JSON больше не возникает `AttributeError`.
* Повысили безопасность.
#### 6.6.0.1 – 02.06.2026
* Обновили внутренние зависимости.
#### 6.6.0 – 19.05.2026
* Обновили модели.
* API больше не возвращает ошибку 500 при печати отчета или просмотре информации по анализу при использовании Web UI с ролью CLIENT.
#### 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.2025**
* Оптимизировали API и улучшили его производительность.
#### **6.2.3 – 02.06.2025**
* Анализы теперь могут выполняться параллельно друг другу. Для включения опции установите значение `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.2025**
* Оптимизировали хранилище и базу данных.
* Добавили новый способ отправки данных на анализ: [единый запрос](/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
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/zhurnal-izmenenii.md?ask=&goal=
```
`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.