Загрузка файла в директорию, которая указана в идентификаторе.
В результате файл будет перемещен в нужную директорию, для этого должно хватать места на диске. Если в директории уже есть файл с подобным именем, к имени будет добавлен постфикс в виде цифры - (1) и т.д.
Для загрузки необходимо сгенерировать uuid и передать его в качестве уникального хеш-значения для тела файла.
Для загрузки файла целиком передается заголовок Content-Range со значением bytes 0-[size]\/[size] (Например, bytes 0-1000/1000) и загружается полностью.
Возможна загрузка по частям, для этого файл должен быть разбит на равные части не меньше 5 мегабайт, кроме последней, остаток может иметь любой размер.
Размер каждой части многокомпонентной загрузки должен составлять от 5 мегабайт (5 242 880 байт) до 5 гигабайт (5 368 709 120 байт).
Заголовок задается по шаблону: bytes [range-start]-[range-end]\/[size] (Например, bytes 0-5242880/7340032 для загрузки первой части в 5 мегабайт для файла размером 7 мегабайт и bytes 5242880-7340032/7340032 для загрузки второй части файла).

Запрос

POST /pub/v1/disk/directory/{id}/upload

Параметры пути (path)

Имя параметра Тип Описание Дополнительно
id uuid

name: id
Идентификатор папки

Обязательный

Параметры запроса (query)

Имя параметра Тип Описание Дополнительно
Hash uuid

Идентификатор тела файла

Обязательный

Параметры формы

Имя параметра Тип Описание Дополнительно
File file

name: File
Загружаемый файл

Авторизация

Запрос обязательно должен использовать один из следующих методов авторизации: API key

Ответ

Могут быть возвращены следующие коды состояния HTTP.

HTTP статус Описание Модель ответа
200 OK

Файл загружен полностью

206 Partial Content

Часть файла загружена успешно

400 Bad Request

Ошибка отображается в формате сообщения, описывающего проблему. Также текст ошибки может содержать следующие коды EntityTooSmall файл разбит на слишком маленькие части, InvalidPart одна из частей не найдена в хранилище, InvalidPartOrder неверный порядок частей в файле, NoSuchUpload загрузка не найдена

402 Payment Required

На диске закончилось место

403 Forbidden

Доступ для создания файла запрещен

default

Ответ сервера после загрузки файла в директорию

Ответ сервера после загрузки файла в директорию (Загрузка файла в директорию)