HTTP-метод

HTTP-метод - это часть протокола, которая задает тип действия над ресурсом.

Простыми словами: метод определяет, что клиент хочет сделать с данными на сервере.

Базовые методы в ежедневной практике:

1. GET - получить данные

• Назначение: чтение ресурса без изменения его состояния.
• Обычно не требует body.
• Пример: curl "https://api.example.com/items/42"

1. POST - создать или инициировать операцию

• Назначение: отправка новых данных или запуск серверного действия.
• Часто используется с JSON body.
• Пример: curl -X POST "https://api.example.com/items" -H "Content-Type: application/json" -d "{\"name\":\"demo\"}"

1. PUT - заменить ресурс целиком

• Назначение: полная замена представления ресурса.
• Обычно требует body с полной структурой.
• Пример: curl -X PUT "https://api.example.com/items/42" -H "Content-Type: application/json" -d "{\"name\":\"updated\",\"active\":true}"

1. PATCH - частично изменить ресурс

• Назначение: изменение только части полей.
• Часто используется для точечных обновлений.
• Пример: curl -X PATCH "https://api.example.com/items/42" -H "Content-Type: application/json" -d "{\"active\":false}"

1. DELETE - удалить ресурс

• Назначение: удаление объекта или деактивация сущности.
• Может требовать авторизацию и дополнительные условия доступа.
• Пример: curl -X DELETE "https://api.example.com/items/42"

Технические замечания:

• Метод может быть задан неявно (по умолчанию GET) или явно через -X.
• Для методов с body важно согласовать формат данных и заголовки.
• Корректный выбор метода влияет на семантику API, кэширование и обработку ошибок.

Практический вывод:

• Метод выбирается по смыслу операции, а не "по привычке".
• Если метод выбран неверно, даже корректный URL и payload не гарантируют правильный результат.