Какие типы данных могут передаваться в body HTTP-запроса?

Тело (body) HTTP-запроса используется для передачи данных от клиента к серверу, например, при отправке формы, создании ресурса через API или загрузке файла. Конкретный формат этих данных указывается в обязательном заголовке Content-Type, который сообщает серверу, как правильно разобрать полученный поток байтов.

Основные форматы тела запроса

• application/x-www-form-urlencoded: Стандартный формат для данных HTML-форм. Данные кодируются в виде пар ключ=значение, объединённых символом &, а специальные символы заменяются на процентное кодирование. Например: name=John+Doe&age=30.
• multipart/form-data Используется, когда нужно отправить файлы вместе с текстовыми полями. Тело разделяется на части (parts) границей (boundary), каждая часть содержит свои заголовки и данные. Это позволяет передавать бинарные данные без потерь.
• application/json Наиболее популярный формат для REST API. Данные передаются в виде строки JSON, что удобно для сложных вложенных структур. Например: {"title": "Post", "published": true}.
• text/plain, application/xml, application/octet-stream Также возможны: простой текст, XML или произвольные бинарные данные (например, для загрузки картинки или PDF).

Пример кода отправки разных типов

Ниже показано, как отправить запросы с разными типами контента с помощью JavaScript (Fetch API).

// 1. JSON
fetch('/api/users', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'Alice', age: 25 })
});

// 2. Form-encoded данные
const formData = new URLSearchParams();
formData.append('username', 'john');
formData.append('password', 'secret');

fetch('/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: formData
});

// 3. Multipart (с файлом)
const multiPartForm = new FormData();
multiPartForm.append('document', fileInput.files[0]);
multiPartForm.append('comment', 'Please review');

fetch('/upload', {
  method: 'POST',
  // Заголовок Content-Type НЕ указывается явно, браузер сам установит с boundary
  body: multiPartForm
});

Выбор формата зависит от задачи: JSON — для API, form-urlencoded — для простых форм, multipart — для загрузки файлов. Всегда указывайте правильный Content-Type, иначе сервер может не распознать данные.