Метод POST: добавление товара
Как администратор добавляет товар в каталог: POST-запрос, тело запроса, код 201 и новая строка в базе данных.
О продукте
Привет! Ты уже знаешь, как покупатель загружает каталог BB Food. Теперь посмотрим на другую сторону: у магазина есть админка, где администратор добавляет новые товары. Здесь клиент уже не просто читает данные, а отправляет их на сервер.
Интересно! А как это работает?
Лучше всего это объяснит Кадри: Кадри уже ждёт тебя в переговорке. Сегодня разбираем только позитивный сценарий: всё идёт как надо.
Привет! Помнишь метод GET? Он получает данные и ничего не меняет. А администратору нужно другое: создать новый товар в каталоге. Для этого в HTTP есть метод POST.
Привет, Кадри! А чем POST отличается от GET?
GET значит «получить», а POST — «создать». Клиент отправляет POST-запрос вместе с данными нового товара. Вот как он выглядит:
Запрос
POST /api/v1/products
{
"name": "Творог, 200 г",
"price": 1.89
}- метод — что сделать.
POSTзначит «создать» - адрес — с чем.
/api/v1/products— тот же список товаров, что и в GET - тело запроса (request body) — данные, которые клиент отправляет серверу. Здесь это название и цена нового товара в формате JSON.
idв запросе нет намеренно: клиент его не передаёт, номер новому товару назначит база данных на стороне сервера
А что сервер отвечает на такой запрос?
Сервер сохраняет товар в базе данных и присылает ответ. Код 201 Created значит «создано» — это успешный ответ именно для POST. В теле ответа сервер возвращает созданный товар. Обрати внимание на id: клиент его не отправлял, номер присваивает база данных.
Ответ
201 Created
{
"id": 8,
"name": "Творог, 200 г",
"price": 1.89
}- код статуса — как всё прошло.
201 Createdзначит «создано» - тело ответа (response body) — созданный товар, уже с
id
На заметку. По стандарту HTTP на создание отвечают кодом 201 Created. Но на практике бывает и 200 OK: это зависит от того, как сделан сервер. Если в команде договорились, что при создании возвращается 200, это не ошибка. Просто запомни, что так бывает, и сверяйся с документацией API.
Проверим, всё ли понятно. Администратор заполнил форму и нажал «Добавить товар». Какой метод отправит клиент?
Давай посмотрим на практике!
Вот админка BB Food. Пример товара уже подставлен в форму, можешь изменить его. Нажми «Добавить товар» и проследи путь запроса: клиент → сервер → база данных → сервер → клиент.
Тестируемое приложение
Сценарий. Позитивный: администратор добавляет товар
Введите название и цену — число больше нуля.
Сервер ждёт запросов. Нажми «Добавить товар», чтобы клиент отправил запрос POST /api/v1/products.
Анимация замедлена: в реальности весь путь занимает десятки миллисекунд.
| id | name | price |
|---|---|---|
| 1 | Бананы, 1 кг | 1.49 |
| 2 | Помидоры черри, 250 г | 2.29 |
| 3 | Молоко 2,5 %, 1 л | 1.19 |
| 4 | Сыр гауда, 200 г | 2.99 |
| 5 | Ржаной хлеб | 1.79 |
| 6 | Апельсиновый сок, 1 л | 2.49 |
| 7 | Селёдка, 300 г | 3.29 |
Готово! Товар сохранён в базе данных, а сервер вернул 201 Created и созданный товар вместе с id. Посмотри на таблицу: в ней появилась новая строка. Значит, POST в отличие от GET изменил данные на сервере.
А что будет, если администратор нажмёт «Добавить товар» ещё раз с теми же данными?
А что мне тут проверять?
Проверь три вещи. Первое: код ответа 201 Created (или тот, о котором договорилась команда). Второе: в ответе есть id, а название и цена такие, как ввёл администратор. Третье: товар появился в таблице базы данных, а значит, покупатель увидит его в каталоге, когда клиент запросит список товаров через GET /api/v1/products. Сам POST этот список не показывает — для этого нужен отдельный GET-запрос. Это и есть позитивный сценарий POST.
Справка по теме
Метод POST
POST /api/v1/products означает «создать». Клиент отправляет данные в теле запроса, а сервер сохраняет их в базе данных. В отличие от GET, POST меняет данные на сервере.
Тело запроса
Данные, которые клиент отправляет серверу, чаще всего в формате JSON. Для нового товара это название и цена.
Код 201 Created
Успешный ответ на создание. В теле ответа сервер обычно возвращает созданный объект, уже с идентификатором.
Идентификатор (id)
Клиент его не отправляет: уникальный номер новой записи присваивает база данных.
Повтор POST
Каждый POST создаёт новую запись, поэтому повторный запрос с теми же данными даст дубль. У GET такой проблемы нет: он только читает данные.
Что проверяет тестировщик
Код ответа 201 (или тот, о котором договорилась команда). В ответе есть id, а название и цена совпадают с введёнными. Новая строка появилась в базе данных, и покупатель видит товар в каталоге.