cURL Basics — документация К тестеру

Тело запроса (payload) и флаг (-d)

Текст термина (дословно из источника)

#### Тело запроса (боди, пейлоад) в HTTP

Тело запроса - это данные, которые клиент отправляет серверу.

Простыми словами: это "содержимое" запроса.

Технически body обычно передают для POST, PUT, PATCH:

  • JSON;
  • form data;
  • другие форматы, ожидаемые сервером.

Практика:

  • Формат body должен соответствовать Content-Type; иначе сервер может вернуть ошибку валидации или проигнорировать данные.

#### Передача тела запроса через флаг -d в cURL

Тело запроса - это полезные данные, которые отправляются серверу.

Простыми словами: это содержимое операции создания или изменения.

Типичный JSON-пример:

curl -X POST "https://api.example.com/items" -H "Content-Type: application/json" -d "{\"name\":\"demo\"}"

Технические правила для body:

  • Body обычно используют с POST, PUT, PATCH.
  • Формат body должен соответствовать Content-Type.
  • Пустое или некорректное тело может вызвать 400/415 и ошибки валидации.

Итог по уровню 2.1:

  • URL отвечает на вопрос "куда".
  • Метод - "что сделать".
  • Заголовки и body - "в каком формате и с какими данными".
  • Опции cURL связывают это в воспроизводимую команду.