Какие HTTP-методы обычно используются при проектировании REST API? Чем отличается семантика PUT от PATCH?

Question

В REST чаще всего используют методы GET, POST, PUT, PATCH, DELETE. GET служит для получения данных, POST — для создания, PUT — для полного обновления ресурса, а PATCH — для частичного. Разница между PUT и PATCH заключается в том, что PUT заменяет весь ресурс целиком, а PATCH — изменяет только указанные поля. PATCH подходит для частичных апдейтов, где важно избежать перезаписи всех данных.

YeaHub · Accepted Answer

HTTP-методы и различие между PUT и PATCHREST API строится на семантике стандартных HTTP-методов.1. Основные HTTP-методыGETполучение ресурсане меняет состояниебезопасный и идемпотентныйPOSTсоздание нового ресурсадействие не идемпотентносервер определяет итоговый результат (например, id)PUTполное обновление ресурсаидемпотентныйклиент отправляет полное состояние сущностиPATCHчастичное обновлениене обязательно идемпотентныйотправляется только набор измененийDELETEудаление ресурсаидемпотентныйДополнительно могут использоваться: OPTIONS, HEAD, TRACE, CONNECT.2. Разница между PUT и PATCHОпределение PUTPUT — метод, который заменяет существующий ресурс его новой полной версией.Пример:phpPUT /users/10
{
    "name": "John",
    "email": "john@example.com",
    "age": 30
}
Даже если возраст не изменился, клиент обязан передать всё.Если поле отсутствует — сервер может считать, что его нужно удалить/сбросить.Определение PATCHPATCH — частичное обновление ресурса: клиент передаёт только изменённые поля.Пример:phpPATCH /users/10
{
    "email": "new@example.com"
}
Другие поля остаются без изменений.3. Когда использовать PUTсинхронизация полного состояния ресурсазаменяемые сущности (кэш, настройки)при idempotent API, где повтор запроса должен давать одинаковый результат4. Когда использовать PATCHобновление отдельных полейоптимизация сетевого трафикасложные или выборочные апдейтыPATCH лучше подходит в большинстве реальных API, где частичное обновление приходит чаще полного.5. ВыводREST API опирается на семантику HTTP-методов. PUT — для полного замещения ресурса, PATCH — для частичного обновления. Разница важна при проектировании стабильных и предсказуемых API.