Какие основные методы HTTP используются в REST API и каково их назначение?

Question

Основные методы HTTP (или "глаголы") определяют тип операции, которую клиент хочет выполнить с ресурсом. GET используется для безопасного получения данных с сервера, не изменяя их. POST служит для создания нового ресурса или отправки данных на обработку. PUT применяется для полного обновления существующего ресурса, а PATCH — для его частичного обновления. DELETE, как следует из названия, удаляет ресурс. Эти методы придают API единообразную и понятную структуру.

YeaHub · Accepted Answer

REST API строится поверх протокола HTTP, используя его стандартные методы для выполнения операций CRUD (Create, Read, Update, Delete) над ресурсами. Понимание семантики каждого метода критически важно.Семантика ключевых HTTP-методовКаждый метод имеет определенное назначение и свойства (идемпотентность и безопасность).1. GETНазначение: Получение (чтение) представления ресурса.Свойства: Безопасный (safe) и Идемпотентный (idempotent).Безопасный: Вызов метода не должен изменять состояние сервера. Можно вызывать много раз без последствий.Идемпотентный: Многократный повтор одного и того же запроса дает тот же результат, что и однократный.Пример: GET /api/users/123 — получить информацию о пользователе с ID 123.2. POSTНазначение: Создание нового ресурса или запуск процедуры, которая не подходит под другие методы (например, поиск с сложными критериями).Свойства: Не безопасный, Не идемпотентный (в общем случае).Пример: POST /api/users с телом {"name": "Alice"} — создать нового пользователя. Повторный вызов с теми же данными, скорее всего, создаст второго идентичного пользователя.3. PUTНазначение: Полное обновление ресурса. Клиент отправляет новое представление ресурса, которое полностью заменяет старое.Свойства: Не безопасный, Идемпотентный. Многократная отправка одного и того же PUT-запроса должна оставлять ресурс в одном и том же состоянии (последующие вызовы ничего не меняют).Пример: PUT /api/users/123 с телом {"name": "Bob", "email": "bob@mail.com"} — заменить все данные пользователя 123 на новые.4. PATCHНазначение: Частичное обновление ресурса. Клиент отправляет только те поля, которые необходимо изменить.Свойства: Не безопасный, Идемпотентный (должен быть спроектирован как идемпотентный).Пример: PATCH /api/users/123 с телом {"email": "new@mail.com"} — обновить только email пользователя 123, оставив остальные поля без изменений.5. DELETEНазначение: Удаление указанного ресурса.Свойства: Не безопасный, Идемпотентный. Удаление ресурса первый раз возвращает успех (или 404), последующие вызовы должны возвращать тот же результат (ресурс уже удален).Пример: DELETE /api/users/123 — удалить пользователя с ID 123.Вывод: Правильное использование HTTP-методов (GET для чтения, POST для создания, PUT/PATCH для обновления, DELETE для удаления) делает API интуитивно понятным и соответствует принципам REST. Свойства идемпотентности и безопасности важны для обеспечения надежности и предсказуемости взаимодействия, особенно в нестабильных сетевых условиях.