# Посторінковий список файлів хмарного сховища

Посторінково виводить файли 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)
    Дата оновлення.