Для чего используется PATCH?

HTTP-метод PATCH предназначен для частичного обновления существующего ресурса. В RESTful архитектуре это позволяет клиенту отправить набор изменений ("патч"), а не полное представление ресурса.

Основная идея и отличие от PUT

Метод PUT предполагает идемпотентную замену ресурса целиком. Клиент должен отправить полное новое состояние. PATCH же не является идемпотентным по умолчанию (хотя может быть спроектирован таковым) и предназначен для применения дельты изменений.

Формат запроса

Спецификация не диктует единый формат для описания изменений. Чаще всего используется JSON Patch (стандарт RFC 6902) или простой JSON-объект с изменяемыми полями (де-факто стандарт для многих API).

Пример кода (JSON Patch)

// Запрос PATCH /users/123
// Content-Type: application/json-patch+json
[
  { "op": "replace", "path": "/email", "value": "new@example.com" },
  { "op": "add", "path": "/tags", "value": ["premium"] }
]

Пример кода (простой JSON)

// Запрос PATCH /users/123
// Content-Type: application/json
{
  "email": "updated@example.com",
  "age": 30
}

Где применяется

• В RESTful API для обновления профилей пользователей, настроек, статей.
• В системах, где передача полного ресурса затратна (большие документы).
• Для минимизации риска конфликтов при параллельных изменениях разных полей.

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