Перейти на PRO

Что входит в тело запроса (Request Body) в REST API и когда оно используется?

Тип вопроса: API тестирование Вероятность: 10% Категория: QA Тестировщик

Ответ

Тело запроса (Request Body) в REST API — это часть HTTP-запроса, которая содержит данные, отправляемые клиентом на сервер для обработки.

Ключевые характеристики:

  • Назначение: Передача данных, необходимых для создания или обновления ресурса (например, JSON-объект нового пользователя).
  • Используется в методах: POST (создание), PUT/PATCH (полное/частичное обновление), иногда DELETE (если для удаления нужны дополнительные параметры).
  • Не используется в: GET, HEAD, OPTIONS (данные передаются через URL-параметры или заголовки).
  • Формат: Определяется заголовком Content-Type. Наиболее распространен application/json.

Примеры тел запросов:

  1. JSON (Content-Type: application/json) — самый частый вариант:

    {
  "title": "Новая задача",
  "completed": false,
  "assigneeId": 45
}

  2. Form Data (Content-Type: application/x-www-form-urlencoded) — как в HTML-формах:

    title=Новая+задача&completed=false&assigneeId=45

  3. Multipart Form Data (Content-Type: multipart/form-data) — для отправки файлов вместе с данными.

Почему важен заголовок Content-Type? Сервер использует его, чтобы правильно распарсить (интерпретировать) полученные данные. Указание неверного типа — частая причина ошибок 400 Bad Request.

Ответ 18+ 🔞

А, слушай, вот эта самая "тело запроса" в REST API — это, блядь, как посылка с данными, которую ты суёшь в почтовый ящик сервера. Не просто открытку с адресом (это URL), а прям коробку с начинкой, ёпта.

Короче, суть:

  • Зачем нужно? Чтобы отправить на сервер всё, что нужно для создания или обновления какой-то хуйни. Например, данные нового пользователя: имя, пароль, аватарку — всю эту пиздопроебибну.
  • Когда тыкаешь? В основном в трёх случаях: когда создаёшь что-то новое (POST), когда обновляешь что-то целиком (PUT) или кусками (PATCH). Иногда даже в DELETE суёшь, если для удаления надо что-то подтвердить. А вот в GET его нихуя не бывает — там всё через URL ковыряют.
  • Формат? А вот тут, блядь, самое важное! Как эту коробку запаковать. И ты обязан написать на ней маркером — заголовок Content-Type, а то сервер, мудак, не поймёт, что ему прислали.

Примеры упаковки, блядь:

  1. JSON (Content-Type: application/json) — это как стандартная, всеми любимая коробка. Всё аккуратненько, структурированненько.

    {
  "title": "Новая задача",
  "completed": false,
  "assigneeId": 45
}

  2. Form Data (Content-Type: application/x-www-form-urlencoded) — старый дедовский способ, как из прошлого века. Всё в одну строку склеено, знаками &.

    title=Новая+задача&completed=false&assigneeId=45

  3. Multipart Form Data (Content-Type: multipart/form-data) — это когда тебе надо в ту же коробку и бумажки засунуть, и бутерброд, и хрен знает что ещё. Используется, когда файлы отправляешь вместе с текстом.

И запомни, чувак: если забудешь или неправильно укажешь этот самый Content-Type — сервер тебе сразу в ответ: "Чё за хуйню ты мне прислал, а?" — и шлёт ошибку 400 Bad Request. Так что не выёбывайся, пиши правильно, ёпта.

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