Функция требует авторизации
Описание - Создает сессию для загрузки больших файлов несколькими порциями.
Параметры
| Имя | Описание | Тип | Пример |
| folderId
отправка в url
|
ИД папки, в которую загружается файл | строка | какой-либо текст |
| fileName
отправка в body
|
Имя загружаемого файла | строка | какой-либо текст |
| fileSize
отправка в body
|
Размер загружаемого файла в байтах | число | 1234 |
| relativePath
отправка в body
|
Относительная папка из folderId | строка | какой-либо текст |
Ремарка - Размер каждой порции данных может быть разным. Но важно помнить, что он должен быть кратен 512 и составлять не менее 5 МБ. Последняя порция данных может быть любого размера. После ответа на начальный запрос со статусом "200 OK" вам необходимо узнать значение поля "location" (местоположение) в ответе. Отправьте все свои порции в это местоположение. Каждую порцию данных требуется отправлять, строго соблюдая порядок их расположения в файле. Если после получения каждой порции данных ошибок не произошло, сервер отправит ответ с текущей информацией о сеансе загрузки. Когда количество загруженных байтов равно количеству байтов, отправленных вами в начальном запросе, сервер отправит ответ "201 Created", а также отправит вам сведения о загруженном файле.
Возвращает - Информация о созданной сессии. А именно:
- id: уникальный ИД этой сессии загрузки
- created: время создания сессии в формате UTC
- expired: время окончания сессии в формате UTC, которое происходит, если к этому моменту не были отправлены порции данных
- location: URL-адрес, по которому вам нужно отправить следующую порцию данных
- bytes_uploaded: Если параметр существует, он содержит количество байтов, загруженное для определенного ИД загрузки
- bytes_total: Количество загружаемых байтов