Get

[POST] …/v1/file/get

Возвращает список файлов, доступных текущему пользователю, с учётом ACL файлов и папок.

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

Название	Тип данных	Обязательность	Описание
ids	Array of Int64	Необязательный	Фильтр по ID файлов
user_id	Int64	Необязательный	Фильтр по владельцу
folder_id	Int64	Необязательный	Фильтр по папке
access_level	Enum	Необязательный	Фильтр по уровню доступа
search	String	Необязательный	Поиск по имени файла
sort_orders	Array of SortOrders	Необязательный	Сортировка
limit	Int32	Необязательный	Лимит
offset	Int32	Необязательный	Смещение

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

{
  "folder_id": 10,
  "limit": 50,
  "offset": 0
}

Поля сортировки

id, date, name, size, extension, user_id, access_level, last_update

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

Название	Тип данных	Описание
result	Array of File	Массив файлов
next_offset	Int32	Смещение следующей страницы
total	Int32	Общее количество

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

{
  "ok": true,
  "result": [
    {
      "id": 101,
      "name": "invoice_2026_01.pdf",
      "size": 34567,
      "extension": "pdf",
      "mime_type": "application/pdf",
      "date": 1767225600,
      "user_id": 501,
      "access_level": "personal",
      "hash": "ab52f8ce4f4e9f8b7f1d4b9d3c12e6a8b0f1e2345f6a7b8c9d0e1f2a3b4c5d6e",
      "folder": {
        "id": 10,
        "name": "Invoices",
        "parent_id": 1,
        "user_id": 501,
        "access_level": "personal",
        "date": 1767139200,
        "last_update": 1767139200,
        "deleted": false
      },
      "folder_id": 10,
      "url": "https://cdn.example.com/files/101",
      "last_update": 1767229200
    }
  ],
  "next_offset": 0,
  "total": 1
}