PATCH

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

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

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

PATCH (как и PUT) может иметь побочные эффекты на другие ресурсы.

Чтобы обозначить, что сервер поддерживает PATCH, можно добавить этот метод в список заголовков ответа Allow или 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

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

Ответ

Успешный ответ указывается с помощью кода ответа 204, поскольку ответ в примере не содержит тела сообщения. А если бы содержал, то код был бы 200.

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

Спецификации

Спецификация Заголовок
RFC 5789: PATCH PATCH Method for HTTP

Смотрите также