Метод POST: добавление товара

Как администратор добавляет товар в каталог: POST-запрос, тело запроса, код 201 и новая строка в базе данных.

О продукте

Алекс, QA-тимлид

Привет! Ты уже знаешь, как покупатель загружает каталог BB Food. Теперь посмотрим на другую сторону: у магазина есть админка, где администратор добавляет новые товары. Здесь клиент уже не просто читает данные, а отправляет их на сервер.

Справка по теме

Метод POST

POST /api/v1/products означает «создать». Клиент отправляет данные в теле запроса, а сервер сохраняет их в базе данных. В отличие от GET, POST меняет данные на сервере.

Тело запроса

Данные, которые клиент отправляет серверу, чаще всего в формате JSON. Для нового товара это название и цена.

Код 201 Created

Успешный ответ на создание. В теле ответа сервер обычно возвращает созданный объект, уже с идентификатором.

Идентификатор (id)

Клиент его не отправляет: уникальный номер новой записи присваивает база данных.

Повтор POST

Каждый POST создаёт новую запись, поэтому повторный запрос с теми же данными даст дубль. У GET такой проблемы нет: он только читает данные.

Что проверяет тестировщик

Код ответа 201 (или тот, о котором договорилась команда). В ответе есть id, а название и цена совпадают с введёнными. Новая строка появилась в базе данных, и покупатель видит товар в каталоге.