Перейти на PRO

Какой стандартный способ отправки файлов через REST API?

Тип вопроса: Архитектура Вероятность: 10% Категория: Python Разработчик

Ответ

Стандартным и наиболее распространенным способом отправки файлов через REST API является использование HTTP-метода POST или PUT с Content-Type: multipart/form-data.

Этот подход позволяет передавать бинарные данные (файл) вместе с метаданными (например, имя пользователя, описание файла) в одном запросе.

Ключевые моменты:

  1. HTTP-метод: Чаще всего POST для создания нового ресурса (файла).
  2. Заголовок Content-Type: Устанавливается в multipart/form-data.
  3. Тело запроса: Форматируется как набор "частей" (parts), где каждая часть имеет свои заголовки и данные. Одна часть содержит файл, другие — текстовые поля.

Пример на Python с библиотекой requests

Этот код демонстрирует отправку файла report.xlsx вместе с дополнительным полем report_type.

import requests

# URL эндпоинта на сервере для загрузки файлов
url = 'https://api.example.com/upload'

# Путь к файлу, который нужно отправить
file_path = 'reports/report.xlsx'

# Дополнительные данные для отправки
form_data = {'report_type': 'monthly'}

# Файл открывается в бинарном режиме для чтения ('rb')
with open(file_path, 'rb') as f:
    # 'file' - это имя поля, которое ожидает сервер
    files = {'file': (f.name, f, 'application/vnd.ms-excel')}

    # Отправка запроса
    response = requests.post(url, data=form_data, files=files)

print(f"Статус-код: {response.status_code}")
print(f"Ответ сервера: {response.json()}")

Альтернативы

  • Base64-кодирование: Файл кодируется в строку Base64 и вставляется в тело JSON-запроса. Это увеличивает размер данных примерно на 33% и требует декодирования на сервере.
  • Raw binary: Отправка файла как есть в теле запроса с соответствующим Content-Type (например, image/png). Этот метод не позволяет передавать метаданные вместе с файлом.

Ответ 18+ 🔞

Да ты посмотри, какой народ-то пошёл! Все эти ваши REST API, POST, PUT... А как файлик отправить — сразу в ступор впадают, блядь. Ну слушай сюда, я тебе сейчас на пальцах объясню, как это делается, чтобы даже мой кот, сука собака, понял.

Стандартный и самый распиздяйский способ — это взять и запихнуть файл в запрос с типом multipart/form-data. Вот прям как в старые добрые формы на сайтах, только через API, блядь. Берёшь метод POST (реже PUT) и впердоливаешь туда всё, что надо.

Ключевые моменты, чтобы не облажаться:

  1. Метод HTTP: Чаще всего POST, потому что ты же новый файл создаёшь, а не старый меняешь, ёпта.
  2. Заголовок Content-Type: Выставляешь в multipart/form-data. Библиотеки умные сами это сделают, если ты файлы правильно укажешь.
  3. Тело запроса: Делится на куски — «парты». Один кусок — твой файл, другие куски — всякая текстовая хуйня вроде названия или описания.

Пример на Python, чтобы ты не выебывался

Смотри, как это просто, даже я, пизда бородавчатая, запомнил. Используем библиотеку requests.

import requests

# Куда шлём наш шедевр
url = 'https://api.example.com/upload'

# Где лежит файл, который надо отправить
file_path = 'reports/report.xlsx'

# Любые дополнительные поля, которые сервер жрёт
form_data = {'report_type': 'monthly'}

# Открываем файл в бинарном режиме, 'rb' — это святое, не перепутай
with open(file_path, 'rb') as f:
    # 'file' — это имя поля, которое ждёт сервер. Может быть 'attachment', 'document' — смотри в документации, ебать!
    files = {'file': (f.name, f, 'application/vnd.ms-excel')}

    # Самый главный выстрел
    response = requests.post(url, data=form_data, files=files)

print(f"Статус-код: {response.status_code}")
print(f"Ответ сервера: {response.json()}")

Вот и всё, волнение ебать! Файл полетел, метаданные прицепились. Сервер, если не идиот, всё примет и обработает.

А есть другие способы?

А как же, их дохуя! Но они либо для особых случаев, либо просто кривые.

  • Base64-кодирование: Это когда ты файл превращаешь в огромную текстовую строку и суёшь её в JSON. Размер вырастает на треть, серверу потом надо это декодировать — одним словом, ебушки-воробушки, если нет веской причины, не делай так.
  • Raw binary: Просто пушкаешь байты файла в тело запроса. Быстро, но метаданные отдельно не прикрепишь — придётся их в заголовки пихать или вторым запросом слать. Удобно только для простых случаев, когда кроме самого файла нихуя не нужно.

В общем, для 99% случаев бери multipart/form-data и не парься. Работает везде, понятно всем. Ядрёна вошь, даже Герасим из той истории, будь он программистом, справился бы!

© ХакСобесов, 2026
support@hacksobesov.com