Как через REST изменить конкретный ресурс или добавить вложенный элемент: какой метод, URL и где передаются данные?

REST строится вокруг ресурсов, которые адресуются через URL, а действия над ними выражаются HTTP-методами. Чтобы изменить уже существующий ресурс, клиент отправляет запрос на URL, идентифицирующий именно этот ресурс, и передаёт новые данные в теле запроса. Для добавления вложенного элемента используется URL родительской коллекции, а сам элемент описывается в теле.

Изменение существующего ресурса

Есть два основных метода изменения:

• PUT — полная замена ресурса. Клиент присылает полное представление, и сервер перезаписывает объект целиком. Если поля не переданы, они считаются удалёнными или сброшенными.
• PATCH — частичное обновление. Передаются только изменяемые поля, остальные остаются как были.

URL всегда указывает на конкретный ресурс, например /users/42. Данные передаются в теле запроса, обычно в JSON, с заголовком Content-Type: application/json.

PUT /users/42 HTTP/1.1
Content-Type: application/json

{ "name": "Alice", "email": "a@example.com" }

PATCH /users/42 HTTP/1.1
Content-Type: application/json

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

Добавление вложенного элемента

Вложенный ресурс адресуется через родителя: /users/42/orders. Чтобы создать новый заказ у пользователя 42, отправляют POST на эту коллекцию, а тело содержит данные нового заказа. Сервер сам назначает идентификатор и возвращает его в заголовке Location.

POST /users/42/orders HTTP/1.1
Content-Type: application/json

{ "product": "book", "qty": 2 }

HTTP/1.1 201 Created
Location: /users/42/orders/777

Коды ответов

• 200 OK — обновление с телом ответа.
• 204 No Content — обновление без тела.
• 201 Created — создание вложенного ресурса.
• 404 Not Found — родитель или ресурс не существует.
• 409 Conflict — конфликт версий или уникальности.

Итог: для изменения ресурса используйте PUT или PATCH на URL конкретного ресурса, для добавления вложенного элемента — POST на URL коллекции вложений, а сами данные всегда передавайте в теле запроса в JSON.