Метод DELETE: удаление товара
Как администратор удаляет товар из каталога: DELETE-запрос, номер товара в адресе, код 204 и удалённая строка в базе данных.
О продукте
Привет! Мы уже умеем добавлять и изменять товары. Но товары бывают и ненужными: закончились у поставщика или добавлены по ошибке. Теперь посмотрим, как администратор удаляет товар из каталога.
Понятно! А как это работает?
Всё объяснит Кадри: Кадри уже ждёт тебя в переговорке. Разбираем только позитивный сценарий: всё идёт как надо.
Привет! Ты уже знаешь GET (получить), POST (создать), PATCH и PUT (изменить). Чтобы удалить товар, в HTTP есть метод DELETE.
Привет, Кадри! Как выглядит запрос на удаление?
DELETE значит «удалить». Клиент указывает в адресе, какой именно товар нужно удалить, — по его id. Тело запроса не нужно: серверу и так понятно, что делать. Вот запрос на удаление товара с id 3:
Запрос
DELETE /api/v1/products/3
- метод — что сделать.
DELETEзначит «удалить» - адрес — с чем.
/api/v1/products/3— товар сid3. Номер товара стоит прямо в адресе - тела нет: серверу достаточно метода и адреса
А что сервер отвечает на удаление?
Сервер удаляет строку из базы данных и присылает ответ. Код 204 No Content значит «успешно, содержимого нет». Тело ответа пустое: удалённый товар возвращать незачем.
Ответ
204 No Content
- код статуса — как всё прошло.
204 No Contentзначит «удалено, добавить нечего» - тела нет: удалённого товара больше нет, показывать нечего
На заметку: 204 — частый, но не единственный вариант. В зависимости от реализации сервер может ответить, например, 200 OK с телом или 202 Accepted, если удаление выполнится позже.
Проверим. Администратор нажал «Удалить» у товара с номером 3. Какой запрос отправит клиент?
Давай посмотрим на практике!
Вот админка BB Food. Выбери товар и нажми «Удалить». Следи за путём запроса: клиент → сервер → база данных → сервер → клиент.
Тестируемое приложение
Сценарий. Позитивный: администратор удаляет товар
Сервер ждёт запросов. Нажми «Удалить», чтобы клиент отправил запрос DELETE.
Анимация замедлена: в реальности весь путь занимает десятки миллисекунд.
| id | name | price |
|---|
В каталоге больше нет товаров.
Готово! Сервер вернул 204 No Content, а в таблице базы данных строки с этим id больше нет. Значит, товар удалён: покупатель его больше не увидит.
А что вернёт GET /api/v1/products после удаления товара?
А что мне тут проверять?
Проверь три вещи. Первое: код ответа 204 No Content, а тела у ответа нет. Второе: строка с этим id пропала из таблицы базы данных, а остальные товары на месте. Третье: отдельный запрос GET /api/v1/products возвращает список уже без этого товара, значит, покупатели его не увидят.
Итак, ты знаешь все четыре основных действия с данными. Их называют CRUD — по первым буквам английских слов Create, Read, Update, Delete. Вот шпаргалка:
CRUD и методы HTTP
- Create — создать:
POST, успех —201 Created - Read — прочитать:
GET, успех —200 OK - Update — изменить:
PATCH(часть данных) илиPUT(целиком), успех —200 OK - Delete — удалить:
DELETE, успех —204 No Content
Справка по теме
Метод DELETE
DELETE /api/v1/products/3 означает «удалить». Клиент указывает в адресе, что удалить, а сервер удаляет данные из базы. Тело запроса обычно не нужно.
Номер товара в адресе
Адрес вида /api/v1/products/3 указывает на конкретный товар с id 3. Без номера метод относился бы ко всему списку.
Код 204 No Content
Успешный ответ без тела: действие выполнено, а возвращать больше нечего.
Что проверяет тестировщик
Код ответа 204. Строка с этим id пропала из базы данных, остальные на месте. Товар исчез из админки и из каталога для покупателей.