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

Question

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

YeaHub · Accepted Answer

Различие между PUT и PATCHPUT и PATCH оба используются для обновления ресурса, но имеют разную семантику.1. Что такое PUTОпределение: PUT — метод, который полностью заменяет существующий ресурс новым состоянием.Характеристики:полный апдейтидемпотентенклиент отправляет все поля сущностиПример:jsonPUT /users/10
{
  "name": "John",
  "email": "john@example.com",
  "age": 30
}
Даже если изменилось только одно поле — требуется отправить весь объект.Если какое-то поле отсутствует, сервер может интерпретировать это как удаление.2. Что такое PATCHОпределение: PATCH — метод частичного обновления ресурса, изменяющий только указанные поля.Характеристики:частичный апдейтне обязательно идемпотентенпередаются только изменённые поляПример:jsonPATCH /users/10
{
  "email": "new@example.com"
}
Остальные данные пользователя не затрагиваются.3. Когда использовать PUTсервис ожидает полную замену ресурсаудобно синхронизировать данные из внешней системыработа с статичными структурамиважно, чтобы повторный запрос не менял результат4. Когда использовать PATCHчастичное обновлениеэкономия трафикасложные ресурсы с большим количеством полейчастые изменения отдельных полейAPI, где важно не трогать не указанные данныеPATCH чаще встречается в реальных API из-за своей гибкости.5. ВыводPUT — это полная замена ресурса, а PATCH — частичное обновление. Различие важно соблюдать, чтобы API оставался логичным, предсказуемым и соответствовал REST-принципам.