POST api/2.0/files/{folderId}/upload/create_session
Для этой функции требуется аутентификация
Описание
Создает сеанс для загрузки больших файлов несколькими фрагментами в папку с идентификатором, указанным в запросе.
Параметры
| Название | Описание | Тип | Пример |
| folderId sent in url | Идентификатор папки | строковый | текст |
| fileName sent in body | Название файла | строковый | текст |
| fileSize sent in body | Длина файла в байтах | номер | 1234 |
| relativePath sent in body | Папка, которая относится к выбранной папке | строковый | текст |
Замечание
Каждый фрагмент может иметь разную длину, но длина должна быть кратна 512 и больше или равна 10 мб. Последний фрагмент может быть любого размера. После первоначального ответа на запрос со статусом 200 OK вы должны получить значение поля location из ответа. Отправьте все свои фрагменты в это место. Каждый фрагмент должен быть отправлен в точном порядке, в котором фрагменты отображаются в файле. После получения каждого фрагмента сервер ответит текущей информацией о сеансе загрузки, если ошибок не произошло. Когда количество загруженных байт равно количеству байт, которые вы отправили в первоначальном запросе, сервер отвечает статусом 201 Создано и отправляет вам информацию о загруженном файле.
Каждый фрагмент может иметь разную длину, но длина должна быть кратна 512 и больше или равна 10 мб. Последний фрагмент может быть любого размера. После первоначального ответа на запрос со статусом 200 OK вы должны получить значение поля location из ответа. Отправьте все свои фрагменты в это место. Каждый фрагмент должен быть отправлен в точном порядке, в котором фрагменты отображаются в файле. После получения каждого фрагмента сервер ответит текущей информацией о сеансе загрузки, если ошибок не произошло. Когда количество загруженных байт равно количеству байт, которые вы отправили в первоначальном запросе, сервер отвечает статусом 201 Создано и отправляет вам информацию о загруженном файле.
Пример
POST api/2.0/files/some+text/upload/create_session
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json
{
"fileName": "some text",
"fileSize": 1234,
"relativePath": "some text"
}Возвращает
Информация о созданном сеансе, которая включает:
- идентификатор: уникальный идентификатор этого сеанса загрузки
- создан: время UTC, когда сеанс был создан
- истек: время UTC, когда сеанс истечет, если до этого времени не будет отправлено ни одного фрагмента
- местоположение: URL, по которому вам следует отправить свой следующий фрагмент
- bytes_uploaded: количество байтов, загруженных для конкретного идентификатора загрузки
- bytes_total: общее количество байтов, загруженных для конкретного идентификатора загрузки байты, которые будут загружены