Что такое HTTP-методы?

HTTP методы (GET, POST, PUT, PATCH, DELETE)

HTTP методы определяют тип действия которое нужно выполнить с ресурсом. Каждый метод имеет семантическое значение и правила применения.

GET

Получение данных без изменения состояния сервера.

• Безопасный: да
• Идемпотентный: да
• Кэшируемый: да
• Примеры: GET /users, GET /users/123

POST

Создание нового ресурса.

• Безопасный: нет
• Идемпотентный: нет
• Кэшируемый: условно
• Требует тело: да
• Ответ: 201 Created
• Примеры: POST /users, POST /articles/123/comments

PUT

Полная замена существующего ресурса.

• Безопасный: нет
• Идемпотентный: да
• Требует тело: да
• Важно: передаёш ВСЕ поля, непередаданые будут удалены
• Примеры: PUT /users/123

PATCH

Частичное обновление ресурса.

• Безопасный: нет
• Идемпотентный: условно
• Требует тело: да
• Важно: передаёш только изменённые поля
• Примеры: PATCH /users/123

DELETE

Удаление ресурса.

• Безопасный: нет
• Идемпотентный: да
• Ответ: 204 No Content
• Примеры: DELETE /users/123

HEAD

Аналогично GET но без тела ответа.

• Примеры: HEAD /files/huge.zip (узнать размер)

OPTIONS

Получение информации о допустимых методах.

• Примеры: OPTIONS /users

Таблица сравнения

Метод | Безопасный | Идемпотентный GET | да | да POST | нет | нет PUT | нет | да PATCH | нет | условно DELETE | нет | да

Вывод

Правильное использование методов делает API предсказуемым и безопасным.