Метод PATCH: изменение цены
Как администратор меняет часть данных товара: PATCH-запрос только с ценой, код 200 и обновлённый столбец в базе данных.
О продукте
Привет! Мы научились добавлять товары. Но чаще в каталоге нужно просто что-то поправить: например, изменить цену. Сегодня смотрим, как администратор меняет цену товара.
Понятно! А как это работает?
Всё объяснит Кадри: Кадри уже ждёт тебя в переговорке. Разбираем только позитивный сценарий: всё идёт как надо.
Привет! Чтобы изменить уже существующий товар, в HTTP есть методы PATCH и PUT. Начнём с PATCH: он меняет только часть данных.
Привет, Кадри! Как выглядит запрос PATCH?
PATCH значит «частично изменить». Клиент указывает в адресе, какой товар менять, а в теле отправляет только то, что нужно изменить. Например, новую цену товара с id 3:
Запрос
PATCH /api/v1/products/3
{
"price": 1.29
}- метод — что сделать.
PATCHзначит «изменить часть данных» - адрес — с чем.
/api/v1/products/3— товар сid3 - тело запроса (request body) — только изменяемое поле. Название отправлять не нужно: оно останется как было
А что сервер отвечает на PATCH?
Сервер обновляет в базе данных только присланное поле и отвечает кодом 200 OK. В теле ответа сервер возвращает товар целиком, уже с новой ценой, чтобы клиент сразу показал актуальные данные.
Ответ
200 OK
{
"id": 3,
"name": "Молоко 2,5 %, 1 л",
"price": 1.29
}- код статуса — как всё прошло.
200 OKзначит «успешно» - тело ответа (response body) — товар целиком:
id, название и новая цена
На заметку: 200 — частый, но не единственный вариант. В зависимости от реализации сервер может ответить, например, 204 No Content без тела.
Проверим. Администратор хочет изменить только цену товара, название трогать не нужно. Что клиент отправит в теле запроса PATCH?
Давай посмотрим на практике!
Вот админка BB Food. Выбери товар, введи новую цену и нажми «Изменить цену». Следи за путём запроса: клиент → сервер → база данных → сервер → клиент.
Тестируемое приложение
Сценарий. Позитивный: администратор меняет цену товара
Сервер ждёт запросов. Нажми «Изменить цену», чтобы клиент отправил запрос PATCH.
Анимация замедлена: в реальности весь путь занимает десятки миллисекунд.
| id | name | price |
|---|
Введите цену — число больше нуля.
В каталоге больше нет товаров.
Готово! Сервер вернул 200 OK и товар целиком. Посмотри на таблицу: в строке изменилась только цена, а название осталось прежним. Так работает PATCH: меняется то, что прислали.
Что произойдёт с названием товара после запроса PATCH, в теле которого только цена?
А что мне тут проверять?
Проверь три вещи. Первое: код ответа 200 OK, а в теле — товар с новой ценой. Второе: в таблице базы данных изменилась цена, а название и id остались прежними. Третье: отдельный запрос GET /api/v1/products возвращает товар уже с новой ценой, её увидят и покупатели.
Справка по теме
Метод PATCH
PATCH /api/v1/products/3 означает «частично изменить». В теле запроса отправляют только те поля, которые нужно изменить, остальные остаются как были.
Код 200 OK
Успешный ответ. Для PATCH сервер обычно возвращает в теле товар целиком, уже с изменениями.
PATCH и PUT
PATCH меняет часть данных, PUT заменяет объект целиком. Если нужно поправить одно поле, удобнее PATCH.
Что проверяет тестировщик
Код ответа 200, в теле — товар с новой ценой. В базе изменилась только цена, название и id прежние. Новая цена видна в админке и в каталоге.