REST PATCH — частичное изменение ресурса (обычно неидемпотентен, но может быть по контракту).

Использование

  • PATCH /users/123 с изменяемыми полями; формат — JSON Patch/merge-patch или договорной.

Правила

  • Ответы: 200 OK / 204 No Content при успешном применении.

  • Указывать формат частичного обновления в заголовке Content-Type.

  • Идемпотентность зависит от семантики операции и данных.

Пример (merge-patch):

PATCH /users/123 HTTP/1.1
Host: api.example.com
Content-Type: application/merge-patch+json

{"email":"new@example.com"}

HTTP/1.1 200 OK
Content-Type: application/json

{"id":123,"email":"new@example.com","active":true}

Меняем только указанные поля.

Последнее обновление