API Reference
Base URL: https://your-domain/api/v2 — все запросы требуют аутентификации.
Для аутентификации передавайте токен в заголовке:
Authorization: Bearer <token>. Токен можно получить в разделе настроек аккаунта.
Files
POST
/api/v2/upload
Загрузка файла
Загрузка файла в указанную папку. Для файлов более 100 МБ используйте multipart upload.
| Параметр | Тип | Описание |
|---|---|---|
file | binary | Содержимое файла (multipart/form-data) |
folder | string | Путь к папке, например /documents/2026 |
overwrite | boolean | Перезаписать существующий файл (по умолчанию false) |
GET
/api/v2/files/{id}
Получить файл
Скачать файл по идентификатору. Поддерживает Range-запросы для частичного скачивания.
GET
/api/v2/files
Список файлов
Возвращает список файлов в указанной папке с пагинацией. Максимум 100 записей на страницу.
| Параметр | Тип | Описание |
|---|---|---|
folder | string | Путь к папке |
page | integer | Номер страницы (по умолчанию 1) |
limit | integer | Записей на страницу (по умолчанию 20, макс. 100) |
DELETE
/api/v2/files/{id}
Удалить файл
Перемещает файл в корзину. Безвозвратное удаление — через 30 дней или по запросу DELETE /api/v2/files/{id}?permanent=true.
Versions
GET
/api/v2/files/{id}/versions
История версий
Возвращает массив всех сохранённых версий файла с датой изменения и размером.
Folders
POST
/api/v2/folders
Создать папку
Создаёт папку по указанному пути. Вложенные папки создаются автоматически.
Коды ответов
| Код | Описание |
|---|---|
200 | Успешный запрос |
201 | Ресурс создан |
400 | Невалидные параметры |
401 | Не авторизован — проверьте токен |
404 | Файл или папка не найдены |
429 | Превышен лимит запросов (100 req/min) |
500 | Внутренняя ошибка сервера |