Должны ли тела запроса PUT содержать целую сущность?

Question

При определении метода PUT для ресурса требуется / стандартно / обычно включать полное определение ресурса (т. Е. Все необходимое для его создания) или также допустимо отправлять только обновленные поля?

Например, если у меня есть ресурс с 10 атрибутами, включая один, называемый количеством, и я хочу обновить количество до указанного значения.Допустимо ли ставить только количество?

А как насчет остальных 9 атрибутов?Предполагая, что каждый атрибут может обновляться индивидуально, рекомендуется ли определять тело запроса просто для того, чтобы все 10 атрибутов были необязательными?

Answer 1

PUT при использовании RESTful предназначен для замены всего ресурса, поэтому вы захотите включить полный набор атрибутов.

Тем не менее, REST в любом случае используется в большинстве случаев довольно ненадлежащим образом, и если ваш API задокументирован хорошо, вы можете делать все, что считаете наиболее подходящим для вашей ситуации.