Switch to EnglishНа сайт Oz ForensicsOz APIСвязаться с нами

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

Журнал изменений API Core.

6.3.1 – 08.08.2025

  • Повысили безопасность: добавили набор дополнительных проверок для медиафайлов, полученных от наших SDK.

6.3.0 – 05.08.2025

Настоятельно рекомендуем обновиться до этой версии.

  • API 6 теперь поддерживает новые требования регулятора в Казахстане: может извлекать из видеороликов, на которых пользователь делает жесты, кадры с действиями.

  • Если вы хотите ограничить права пользователя с ролью 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

  • Оптимизировали хранилище и базу данных.

  • Добавили новый способ отправки данных на анализ: единый запрос. Этот запрос включает в себя создание папки и назначение анализов в одном и том же запросе – все необходимые данные указываются в payload.

  • Добавили новый режим работы API, при котором данные запроса и ответа не сохраняются ни локально, ни в какой-либо базе данных. Instant API может использоваться и сам по себе, и с другими компонентами API.

  • Теперь можно комбинировать рабочие системы, использующие асинхронные методы или Celery worker (локальная обработка, обработка через Celery). Для каждой из комбинаций добавлена поддержка хранения в S3.

  • Повысили безопасность.

  • Прекратили поддержку RAR-архивов.

  • Длительность анализа теперь считается точнее.

  • Для роли 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 как отдельные объекты. Для сохранения одного из кадров вашего видео вы можете воспользоваться опцией "Лучший кадр".

  • Обновили методы API: Oz API 6.0.

  • Заменили параметры и точки входа:

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

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

5.3.0 – 21.11.2024

  • API теперь может извлекать из видеороликов, на которых пользователь делает жесты, кадры с действиями. Доработка выполнена в связи с вводом новых регуляторных требований к биометрической идентификации в Казахстане. Требования к версиям других компонентов описаны здесь.

  • Подготовили новый шаблон отчета, который также соответствует этим требованиям.

  • Миниатюры для нового отчета генерируются на основе кадров с действиями.

5.2.0 – 06.09.2024

  • Обновили коллекцию Postman. Опубликовали новую коллекцию здесь и на 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

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

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/<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

  • Модули 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.

PreviousКоллекции Postman Oz APINextOz API Lite

Last updated

Was this helpful?