Перейти к основному содержимому

POST /uploads

Описание​

Загружает бинарный файл на сервер и возвращает JSON объект с id файла, именем и URL

Этот маршрут принимает HTTP POST multipart-запрос, отправленный на эндпоинт /uploads.

Тело запроса​

Сервер ожидает бинарный файл, отправленный через запрос multipart/form-data. Как и все multipart MIME запросы, тело должно содержать:

  • заголовок Content-Disposition со значением form-data
    • атрибут name со значением upload
    • поле filename с оригинальным именем загружаемого файла
  • заголовок Content-Type, указывающий тип данных файла

В каждом запросе разрешён только один файл.

Пример:


------WebKitFormBoundarySlwgXDBw7kcKSI4p
Content-Disposition: form-data; name="upload"; filename="myImage.png"
Content-Type: image/png

------WebKitFormBoundarySlwgXDBw7kcKSI4p--

Ответ​

Сервер возвращает JSON объект, содержащий id файла, имя и URL.

Свойство isCover указывает, является ли изображение обложкой (true) или нет (false).

Пример:

{
   "id":4,
   "name":"myImage.png",
   "url":"http://localhost:3000/uploads/4/myImage.png",
   "isCover":false
}

HTTP статус код указывает, был ли запрос успешным (response.status == 200) или произошла ошибка (response.status == 500).

Связанные статьи: Работа с сервером