Тело запроса (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 связывают это в воспроизводимую команду.