В чем разница между PUT и PATCH

PUT полностью заменяет ресурс новыми данными. Если какие-то поля не переданы, они будут установлены в null или значения по умолчанию.

PATCH частично обновляет ресурс, изменяя только переданные поля. Остальные поля остаются без изменений.

Пример для API пользователя:

PUT /users/1
{
  "name": "Alex",
  "age": 30
}

Обнулит все остальные поля пользователя.

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

Обновит только возраст, оставив другие поля (например, имя) без изменений.

PUT идемпотентен (повторные вызовы дают тот же результат), PATCH — не всегда.