Загрузка файла по URL и с ПК отличаются. Для загрузки по URL достаточно указать ссылку на файл в параметре запроса. Загрузка файла с ПК происходит в два этапа:

  1. POST fileSystem/file — добавляет запись о файле для дальнейшей загрузки; 
  2. POST https://events-storage.webinar.ru/api-storage/slowupload — загружает файл в файловое хранилище и записывает метаданные файла в базу. Требования к загружаемым файлам.

МЕТОД HTTP

POST 

URL

https://userapi.webinar.ru/v3/fileSystem/file

ОБЯЗАТЕЛЬНЫЕ ПАРАМЕТРЫ

  • name — имя файла*;
  • url — ссылка на загружаемый файл**.

*для файлов, загружаемых с ПК.
**для файлов, которые загружают по URL.

ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ

  • parent — идентификатор родительской папки;
  • isShared — доступность файла Организации. Значения:
    - true — файл общий для организации;
    - false — файл недоступен для других сотрудников Команды.
    По умолчанию: false;
  • user ID — владельца файла. Можно загрузить файл любому сотруднику Организации.
    По умолчанию: владелец Организации.

ПОЛЯ ОТВЕТА. При загрузке файла по URL

Возвращается информация о добавленном файле. Зависит от типа файла.
Подробнее о параметрах файлов

ПРИМЕР ЗАПРОСА. При загрузке файла по URL

url: https://userapi.webinar.ru/v3/fileSystem/file,
method: POST,
headers:
{
    x-auth-token: {Token},
    Content-Type: application/x-www-form-urlencoded
},
data:
{
    url: https://webinar.ru/themes/webinar-main/assets/images/homepage-new/interactiv.jpg
  }
};

ПРИМЕР ОТВЕТА. При загрузке файла по URL

201 - Created
{
  "id": 61610449,
  "isDeleted": false,
  "createAt": "2019-07-09T11:25:59+0300",
  "name": "04ff3d4fc8b03625e52ec1a4083a754b",
  "type": "file",
  "user": {
    "id": 1029,
    "nickname": "Специалист тех.поддержки",
    "type": "USER",
    "name": "Специалист",
    "secondName": "тех.поддержки"
  },
  "path": "./files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg",
  "url": "https://events-storage.webinar.ru/api-storage/files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg",
  "downloadUrl": "https://events-storage.webinar.ru/api-storage/files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg",
  "thumbnailUrl": "https://events-storage.webinar.ru/api-storage/224x199/files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg",
  "thumbnails": {
    "640x1920": "https://events-storage.webinar.ru/api-storage/640x1920/files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg",
    "1920x1080": "https://events-storage.webinar.ru/api-storage/1920x1080/files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg",
    "1333x1000": "https://events-storage.webinar.ru/api-storage/1333x1000/files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg",
    "224x199": "https://events-storage.webinar.ru/api-storage/224x199/files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg",
    "200x50": "https://events-storage.webinar.ru/api-storage/200x50/files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg",
    "50x50": "https://events-storage.webinar.ru/api-storage/50x50/files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg",
    "34x34": "https://events-storage.webinar.ru/api-storage/34x34/files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg",
    "148x112": "https://events-storage.webinar.ru/api-storage/148x112/files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg"
  },
  "size": 113753,
  "format": "jpg",
  "isHidden": false,
  "isSystem": false,
  "mimeType": "image/jpeg",
  "typeFile": "file",
  "uri": "//events-storage.webinar.ru/api-storage/files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg",
  "thumbnailUri": "//events-storage.webinar.ru/api-storage/224x199/files/webinar/2019/07/09/5kpM8iD1ja19SYVmlBoXKaf1rZx9bzbK1nzZvTFGLVLmxul9.jpg"
}

ПОЛЯ ОТВЕТА. При загрузке файла с ПК

  • id  - уникальный идентификатор файла в файловой системе; 
  • token - уникальный токен для загрузки файла в файловое хранилище.

ПРИМЕР ЗАПРОСА. При загрузке файла с ПК

url: https://userapi.webinar.ru/v3/fileSystem/file,
method: POST,
headers:
{
    x-auth-token: {Token},
    Content-Type: application/x-www-form-urlencoded
},
data:
{
    name: Изображение с компьютера
};

ПРИМЕР ОТВЕТА. При загрузке файла с ПК

201 - Created         
{
  "id": 61610993,
  "token": "93b14a1a480c29d62898a57655cbf47a",
  "slowUploadUrl": "https://events-storage.webinar.ru/api-storage/slowupload?token=93b14a1a480c29d62898a57655cbf47a"
}
Вы нашли ответ?