# Постраничный список файлов облачного хранилища

Постранично выводит файлы Cloud Storage.
- **Эффект**: отсутствует. Только чтение. Повтор безопасен при ограниченной выдержке.
- **Видимость**: **выводятся только файлы, загрузка которых подтверждена**: файл с предподписанным URL, загрузка которого так и не была завершена, не появится. Участники без права на все данные видят только загруженные ими файлы.
- **Фильтрация**: `fileName` сопоставляется частично; `tagIds` работает по логике ИЛИ; результаты упорядочены от новых к старым, и этот порядок изменить нельзя.
- **Особенность**: элемент `tagInfo` может быть равен null, если метка была удалена, пока она ещё была привязана к файлу.

Endpoint: POST /api/cloudstorage/file/page
Version: 2026-09-05

## Request fields (application/json):

  - `pageNo` (integer)
    Номер текущей страницы, начиная с 1. По умолчанию 1.
    Example: 1

  - `pageSize` (integer)
    Количество элементов на странице. По умолчанию 10.
    Example: 20

  - `fileName` (string)
    Ключевое слово имени файла для нечёткого поиска.
    Example: report

  - `tagIds` (array)
    Фильтрует файлы по ID меток.
    Example: ["1800000000000101"]

  - `fileType` (integer)
    Фильтр по типу файла: 0 = изображение, 1 = видео, 2 = приложение, 3 = аудио, 4 = документ, 5 = другое.
    Example: 0

  - `fileIds` (array)
    Фильтрует файлы по ID файлов.
    Example: ["1800000000001001"]

## Response 200 fields (application/json):

  - `code` (integer, required)
    Код результата. `0` означает успех; остальные коды указывают на ошибку.
    Example: 0

  - `msg` (string | null, required)
    Сообщение об ошибке.
    Example: null

  - `requestId` (string)
    ID запроса операции. Это поле может присутствовать, если запрос прошёл через API-шлюз.
    Example: 1d4f3ea968664593860b94b35d4ebf5e

  - `data` (object, required)

  - `data.current` (string, required)
    Example: 1

  - `data.pages` (string, required)
    Example: 7

  - `data.total` (string, required)
    Example: 128

  - `data.dataList` (array, required)

  - `data.dataList.id` (string)
    Идентификатор файла в облачном хранилище.
    Example: 1800000000001001

  - `data.dataList.fileName` (string)
    Имя файла (без расширения).
    Example: example

  - `data.dataList.fileExt` (string)
    Расширение файла.
    Example: jpg

  - `data.dataList.fileSize` (string)
    Размер файла в байтах.
    Example: 204800

  - `data.dataList.fileType` (integer)
    Тип файла: 0 = изображение, 1 = видео, 2 = приложение, 3 = аудио, 4 = документ, 5 = другое.
    Example: 0

  - `data.dataList.tagInfo` (array)
    Подробности меток, привязанных к файлу.

  - `data.dataList.tagInfo.id` (string)
    Идентификатор тега.
    Example: 1800000000000101

  - `data.dataList.tagInfo.tagSource` (string)
    Источник метки, например ENV, PROXY.
    Example: ENV

  - `data.dataList.tagInfo.tagName` (string)
    Название тега.
    Example: Invoice

  - `data.dataList.tagInfo.tagType` (string)
    Тип метки: TAG или GROUP.
    Example: TAG

  - `data.dataList.tagInfo.tagIcon` (string)
    Иконка метки.

  - `data.dataList.createDate` (string)
    Дата загрузки.

  - `data.dataList.updateDate` (string)
    Дата обновления.