PATCH

Метод запроса HTTP PATCH частично изменяет ресурс.

В какой-то степени PATCH можно назвать аналогом действия «обновить» из CRUD (en-US) (однако не следует путать HTTP и CRUD (en-US) — это две разные вещи).

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

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

PATCH (как и POST) может иметь побочные эффекты.

Чтобы обозначить, что сервер поддерживает PATCH, можно добавить этот метод в список заголовков ответа Allow (en-US) или Access-Control-Allow-Methods (для CORS).

Другим (неявным) индикатором, что метод PATCH разрешён, является наличие заголовка Accept-Patch, который описывает, какой формат изменения документа принимает сервер.

Запрос имеет тело	Да
Успешный ответ имеет тело	Может
Безопасный	Нет
Идемпотентный	Нет
Кешируемый	Только если включена информация о дате последнего изменения
Допускается в HTML-формах	Нет

PATCH /file.txt HTTP/1.1

PATCH /file.txt HTTP/1.1
Host: www.example.com
Content-Type: application/example
If-Match: "e0023aa4e"
Content-Length: 100

[описание изменений]

HTTP/1.1 204 No Content
Content-Location: /file.txt
ETag: "e0023aa4f"