Cleanup

[POST] .../v1/storage/cleanup

Запускает асинхронную очистку файлов хранилища по диапазону дат и/или по списку сущностей.

Внимание: если параметры запроса не заданы (передан пустой объект {}), будут удалены все файлы из хранилища.
Папки после очистки не удаляются. Удаляются только файлы.

Права доступа

Метод доступен только владельцу аккаунта (user_id = 1).
Если метод вызывает другой пользователь, возвращается ошибка 1096: Функция доступна владельцу аккаунта.

После запуска очистки права дополнительно проверяются в фоне отдельно по каждой сущности. Если права на сущность нет, эта сущность пропускается.

Сущность	ID	Код права
`chat`	687	`rChatMessageDelete`
`report`	352	`rReportPreparedRemove`
`item`	123	`rCtlgImageDelete`
`payment_type`	132	`rCtlgPaymenttypeEdit`
`contract`	173	`rDocContractFileDelete`
<!--	`print_form`	316	`rCtlgDocPrintformDelete`	-->
`retail_customer_document`	457	`rCtlgCustomerPersonalDocTypesEdit`
`other`	658	`rRbacPermissionCatalogFilesDelete`

Дополнительно учитывается право 659 (rCatalogFilesWorkWithAll):

если право есть, очистка выполняется без ограничения по владельцу файла;
если права нет, удаляются только файлы, которые создал пользователь

Входные параметры

Название	Тип данных	Описание
start_date	Int64	Необязательный. Начальная дата в unix time (включительно).
end_date	Int64	Необязательный. Конечная дата в unix time (включительно).
entities	Array of Enum (String)	Необязательный. Сущности для очистки: `chat`, `report`, `item`, `payment_type`, `contract`, `retail_customer_document`, `other`.

other — это файлы, не привязанные к перечисленным сущностям.

Пример запроса

{
  "start_date": 1735689600,
  "end_date": 1767225599,
  "entities": [
    "chat",
    "report",
    "item"
  ]
}

Выходные параметры

Название	Тип данных	Описание
result	Boolean	`true`, если задача на очистку принята и запущена в фоновом потоке.

Пример ответа

{
  "ok": true,
  "result": true
}