Чем PATCH отличается от PUT?

Основное различие между PATCH и PUT

В REST-архитектуре PUT и PATCH используются для обновления ресурсов, но работают по-разному. PUT заменяет весь ресурс целиком: клиент отправляет полное представление объекта, и сервер сохраняет его как есть. PATCH же применяет частичные изменения — клиент передаёт только те поля, которые нужно обновить, или инструкцию по модификации.

Идемпотентность

PUT является идемпотентным: многократный вызов одного и того же PUT-запроса приводит к одному состоянию ресурса. PATCH может быть неидемпотентным, если изменения накапливаются (например, увеличить счётчик на 1).

Примеры кода

Рассмотрим ресурс пользователя:

// Исходный ресурс
{
  "name": "Alice",
  "email": "alice@example.com",
  "age": 30
}

// PUT — полная замена
PUT /users/1
{
  "name": "Alice",
  "email": "alice@new.com",
  "age": 31
}
// Результат: все поля заменены

// PATCH — частичное обновление
PATCH /users/1
{
  "email": "alice@new.com"
}
// Результат: изменён только email, остальные поля сохранены

Когда что использовать

• Используйте PUT, когда клиент отправляет полное состояние ресурса и хочет его заменить.
• Используйте PATCH для частичных обновлений, чтобы уменьшить объём передаваемых данных и избежать перезаписи неизменённых полей.

Вывод: PUT подходит для полной замены ресурса, PATCH — для точечных изменений. Выбор метода влияет на производительность, идемпотентность и семантику API.