Ваши файлы.
Открытый интерфейс.
Региональный API работает по HTTPS на адресе вашего хранилища. Авторизация — Authorization: Bearer <session>. Токен выдаётся при входе, действует 30 дней и отзывается при выходе или восстановлении аккаунта. Не публикуйте токен.
Аккаунт
POST /api/v2/registerJSON: email, password. Сохраните recoveryCode из ответа.
POST /api/v2/loginJSON: email, password. Ответ: token, csrf, region.
GET /api/v2/sessionРегион, квота, занятое место и версия списка файлов.
POST /api/v2/logoutОтзыв текущей сессии.
Файлы и загрузки
GET /api/v2/files?parent=<id>Список файлов и папок. Без parent — корневая папка.
POST /api/v2/foldersJSON: name, parent (необязательно).
POST /api/v2/uploadsJSON: name, size, parent. Возвращает ID загрузки.
POST /api/v2/transfer?id=<id>&n=<seq>Двоичный чанк, номера с 0. Подтверждение: 200 без тела. Повтор чанка должен содержать те же байты.
POST /api/v2/transfer?id=<id>Потоковая загрузка без n. Поддерживает chunked HTTP/1.1 и поток HTTP/2. Подтверждается после завершения запроса.
GET /api/v2/uploads/<id>Состояние: received, next_seq, done. После обрыва продолжайте с подтверждённого смещения.
POST /api/v2/uploads/<id>/completeJSON: {}. Завершает загрузку, если получены все байты.
GET /api/v2/transfer?id=<file-id>Оригинал файла. Поддерживает Range: bytes=start-end и HEAD.
GET /api/v2/preview/<file-id>Фото, аудио и видео с подходящим Content-Type и поддержкой Range.
Ссылки, корзина и синхронизация
POST /api/v2/files/<id>/shareJSON: lifetime в секундах, от 60 до 2592000. По умолчанию — 7 дней. /unshare отзывает все ссылки на файл.
POST /api/v2/files/<id>/trashJSON: {}. /restore восстанавливает, /purge удаляет окончательно.
GET /api/v2/sync?since=<revision>&wait=25Long-poll до 25 секунд; changed сообщает об изменении файлов.
Ошибки и пределы
Ошибки возвращаются как JSON {"error":"код"}. 401 — нужна авторизация, 403 — проверка CSRF, 404 — объект недоступен, 409 — конфликт, 413 — квота или размер, 429 — частые запросы, 507 — нет свободной ёмкости. В аккаунте до 5000 объектов и 8 незавершённых загрузок; чанк до 2 МБ, глубина папок до 32 уровней. Незавершённые загрузки очищаются через 48 часов без активности.