put.md

PUT

Изменение одного или нескольких полей существующего объекта

CRUD:

Update/Replace

Аргументы

• id объекта передается в строке URL
• любые другие аргументы ДОЛЖНЫ(MUST) передаваться в теле json документа

Ответы

Успешно:

Запрос коллекции:

/customer:

• Code: 200 (Ok)

метод изменяет ВСЮ коллекцию! аналогично sql UPDATE без выражения WHERE, поэтому в большинстве случаев метод заблокирован и должен возвращать ошибку 405 (Method Not Allowed)

Запрос объекта:

/customers/{id}:

• Code: 200 (Ok)
• Body: Ссылка на измененный объект

Ошибки

Неверный payload

в частности, переданы неверные атрибуты или типы атрибутов

• Code: 400 (Bad Request)
• Body: Объект ошибки

Объект с таким ID не найден

• Code: 404 (Not Found)
• Body: Объект ошибки

Подробно

PUT создаёт новый ресурс или заменяет представление целевого ресурса, данными представленными в теле запроса. Разница между PUT и POST в том, что PUT является идемпотентным.

Примеры PUT

Пример изменения объекта

---

НАЗАД <- Соглашения об использовании HTTP методов