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

Методы HTTP PUT и PATCH используются для обновления ресурсов, но отличаются по своей семантике и объему обновления:

• PUT — это идемпотентный метод, который заменяет весь ресурс целиком. При использовании PUT клиент отправляет полное представление ресурса, и сервер заменяет существующий ресурс этим новым состоянием. Если ресурс не существует, он может быть создан.

• PATCH — используется для частичного обновления ресурса. Клиент отправляет только те поля или изменения, которые нужно применить, а сервер обновляет ресурс частично, не затрагивая остальные поля.

Пример:

PUT /users/123
{
  "name": "Иван",
  "age": 30
}

Заменит весь ресурс пользователя с id 123 новым объектом.

PATCH /users/123
{
  "age": 31
}

Обновит только поле age, не меняя имя.

Таким образом, PUT — для полной замены, PATCH — для частичного обновления.