Основные HTTP-методы в REST API

При проектировании REST важно правильно использовать HTTP-методы, так как они несут смысловую нагрузку.

1. Основные методы

1. GET

   • получение данных

   • не изменяет состояние сервера

   • безопасен и идемпотентен

2. POST

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

   • не является идемпотентным

   • сервер обычно генерирует id

3. PUT

   • полное обновление ресурса

   • идемпотентен (повтор запроса даёт тот же результат)

4. PATCH

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

   • изменяются только указанные поля

   • не обязан быть идемпотентным

5. DELETE

   • удаление ресурса

   • идемпотентен (повторный DELETE ничего не ломает)

Дополнительно используются:

• HEAD — получить только заголовки

• OPTIONS — поддержка CORS, preflight-запросы

• PUT/POST/PATCH с Content-Type: application/json — основной формат тела запроса

2. Почему важно соблюдать семантику методов

• улучшает предсказуемость API

• упрощает интеграции

• даёт корректную работу кешей, прокси, браузеров

• снижает риск ошибок при работе с состоянием

3. Вывод

REST API строится на правильной семантике HTTP-методов: GET — читаем, POST — создаём, PUT/PATCH — обновляем, DELETE — удаляем. Это основа корректного и ожидаемого поведения API.