Что такое POST запрос?

POST запрос: полный обзор

POST запрос — это один из основных HTTP методов, который используется для отправки данных на сервер. Если GET запрос получает информацию, то POST создает новый ресурс или выполняет операцию, которая изменяет состояние на сервере.

Основные характеристики POST

Отличия от GET

• GET — получение данных, параметры в URL, видны в истории браузера
• POST — отправка данных, параметры в теле запроса (не видны в URL), безопаснее для чувствительных данных
• POST не кэшируется по умолчанию, в отличие от GET

Структура POST запроса

POST /api/v1/users HTTP/1.1 Host: example.com Content-Type: application/json

Компоненты

• Метод: POST
• URL path: /api/v1/users
• Headers: информация о запросе
• Body: данные, которые отправляются серверу

Content-Type для POST

Основные типы

• application/json — стандарт для REST API, структурированные данные
• application/x-www-form-urlencoded — данные веб-формы
• multipart/form-data — загрузка файлов вместе с другими данными

Практические примеры с curl

JSON запрос

curl -X POST https://api.example.com/users -H Content-Type: application/json -d data

Форма

curl -X POST https://api.example.com/login -H Content-Type: application/x-www-form-urlencoded

С файлом

curl -X POST https://api.example.com/upload -F file=image.jpg

Как тестировать POST запросы

Инструменты

• Postman — UI для создания и проверки запросов
• curl — командная строка, идеально для автоматизации
• Python requests — программный тест API
• REST Client расширения в VS Code

Проверки в тестировании

✓ Правильность status code (200, 201, 400, 401, 500) ✓ Структура response body ✓ Наличие обязательных полей в ответе ✓ Создание ресурса в БД ✓ Валидация данных ✓ Обработка ошибок и error messages ✓ Безопасность (защита от SQL injection, XSS)

Идемпотентность

POST запрос не идемпотентен — повторный вызов создаст новый ресурс. Это отличает его от PUT/PATCH. Важно правильно обрабатывать дублирующиеся POST запросы для избежания создания копий.