Коды ответа: 401, 404, 405 и пустой список
Как сервер сообщает о проблемах: 401 без входа, 405 для неразрешённого метода, 404 при удалении несуществующего товара и 200 OK с пустым списком.
О продукте
Привет! Мы разобрали, как всё работает, когда всё идёт хорошо. Но тестировщик проверяет и то, как сервер сообщает о проблемах: для этого у каждого ответа есть код статуса. Сегодня разберём самые частые коды на примерах из админки BB Food.
Отлично! С чего начнём?
Кадри уже ждёт тебя в переговорке и всё покажет. Сегодня четыре случая: 401, 405, пустой список с кодом 200 и удаление товара, которого уже нет.
Привет! У каждого ответа сервера есть код статуса. Ты уже видел 200, 201 и 204. Первая цифра кода подсказывает, что произошло.
Привет, Кадри! Что означает первая цифра?
Коды делятся на группы по первой цифре. Запомни четыре главные:
Коды статуса
2xx— успех: запрос выполнен (200 OK,201 Created,204 No Content)3xx— перенаправление: ресурс переехал. Например, старую страницу акций/saleудалили, а акции теперь на/promo. НаGET /saleсервер отвечает301 Moved Permanently, в заголовкеLocationуказывает/promo, и браузер сам туда переходит4xx— ошибка клиента: запрос неправильный или его нельзя выполнить (401,404,405)5xx— ошибка сервера: клиент всё сделал верно, но у сервера что-то сломалось (500,503)
Проверим. Сервер ответил кодом 404. Чья это ошибка?
Давай разберём на примерах!
Тестируемое приложение
Пример 1
Первый пример. Администратор открыл админку, но вход в систему не выполнен. Он всё равно пытается добавить товар.
И что ответит сервер?
Клиент отправит запрос на добавление товара, но в нём не будет подтверждения, что его отправил вошедший в систему администратор. Нажми «Добавить товар» и посмотри, что произойдёт.
Запрос
POST /api/v1/products
{
"name": "Творог, 200 г",
"price": 1.89
}- метод и адрес такие же, как при успешном добавлении:
POST /api/v1/products - тело запроса (request body) — данные нового товара, они верные
- подтверждения входа нет: сервер не знает, кто отправил запрос
Анимация замедлена: в реальности весь путь занимает десятки миллисекунд.
| id | name | price |
|---|
Товары ещё не загружены.
Сервер ответил кодом 401 Unauthorized — «не авторизован». Он не знает, кто отправил запрос, поэтому отказал ещё до обращения к базе данных. База в этом сценарии не участвовала, таблица осталась прежней.
Ответ
401 Unauthorized
{
"error": "Unauthorized"
}- код статуса — как всё прошло.
401 Unauthorizedзначит «войдите в систему» - тело ответа (response body) — сообщение об ошибке, а не товар
Что проверяет тестировщик: код 401, товар не добавился в базу, а пользователь видит понятное сообщение и может войти заново.
Что означает код 401?
Понятно! А какой код будет дальше?
Пример 2
Второй пример. Разработчик клиента добавил в админку кнопку «Удалить все товары», но ошибся: она отправляет DELETE на адрес всего списка, а сервер такое действие не поддерживает.
Получится?
Кнопка отправит DELETE на адрес /api/v1/products, то есть на весь список, а не на один товар. Клиент ошибся, но сервер не доверяет клиенту и сам проверяет каждый запрос. Нажми «Удалить все товары» и посмотри, что ответит сервер.
Запрос
DELETE /api/v1/products
- метод — что сделать.
DELETEзначит «удалить» - адрес —
/api/v1/products: весь список, номера товара нет - тела нет
Сервер ответил кодом 405 Method Not Allowed — «метод не разрешён». Адрес существует, но для него сервер поддерживает только GET и POST. База данных не участвовала, все товары на месте.
Ответ
405 Method Not Allowed
{
"error": "Method Not Allowed"
}- код статуса —
405 Method Not Allowedзначит «этот метод для этого адреса не разрешён» - тело ответа (response body) — сообщение об ошибке
Что проверяет тестировщик: код 405, данные в базе не изменились, а пользователь видит понятное сообщение. А ещё заводит баг на клиент: кнопка отправляет запрос, который сервер не поддерживает. Не путай с 404: там не найден сам адрес или ресурс.
Сервер разрешает для адреса /api/v1/products только GET и POST. Клиент отправил DELETE. Какой код вернёт сервер?
А если всё сработало, но данных нет?
Пример 3
Третий пример хитрее. Магазин только открылся, и в базе данных пока нет ни одного товара. Покупатель открывает каталог.
Сервер вернёт ошибку?
Клиент запросит список товаров, как в самом первом задании. Посмотри на таблицу в базе данных: она пуста. Нажми «Загрузить товары» и посмотри, что ответит сервер.
Запрос
GET /api/v1/products
- метод и адрес те же:
GET /api/v1/products - тела нет
- в таблице
productsнет ни одной строки
Сервер ответил кодом 200 OK, а в теле пустой список []. Это не ошибка: запрос выполнен успешно, просто подходящих данных нет. Сервер нашёл в базе 0 строк и честно вернул пустой список.
Ответ
200 OK []
- код статуса —
200 OKзначит «запрос выполнен успешно» - тело ответа (response body) — пустой список
[]: товаров нет, но и ошибки нет
Что проверяет тестировщик: код 200, а не 404 или 500, в теле пустой список [], а на сайте понятная подсказка вроде «Товаров пока нет», а не пустой экран или ошибка.
Сервер вернул 200 OK и пустой список []. Это ошибка?
А что будет, если удалить товар, которого уже нет?
Пример 4
И последний пример. Два администратора работают одновременно. Один уже удалил товар «Молоко 2,5 %, 1 л», а у второго страница не обновилась, и товар в списке всё ещё есть.
И что будет, если удалить его ещё раз?
Обрати внимание: в таблице базы данных товара с id 3 уже нет, а в списке у клиента он ещё есть. Нажми «Удалить «Молоко 2,5 %, 1 л»» и посмотри, что ответит сервер.
Запрос
DELETE /api/v1/products/3
- метод и адрес — как при обычном удалении:
DELETE /api/v1/products/3 - тела нет
- товара с
id3 в базе данных уже нет
Сервер ответил кодом 404 Not Found — «не найдено». База данных не нашла строку с id 3, ничего не удалила и сообщила серверу: удалено 0 строк. Раз удалять нечего, сервер честно ответил, что такого товара нет. Обрати внимание: база данных от повторного DELETE не изменилась — товара нет и после первого запроса, и после второго. Отличается только код ответа: 204 в первый раз и 404 во второй. Поэтому, в отличие от POST, повтор DELETE не создаёт дублей и не портит данные.
Ответ
404 Not Found
{
"error": "Product not found"
}- код статуса —
404 Not Foundзначит «такого ресурса нет» - тело ответа (response body) — сообщение об ошибке
Что проверяет тестировщик: код 404 вместо 204, база данных не изменилась, а пользователь видит понятное сообщение, например, «Товар не найден: возможно, его уже удалили».
Что вернёт сервер при удалении товара, которого уже нет?
Кажется, я разобрался!
Отлично! Теперь ты умеешь читать коды ответа. Запомни: 401 — не вошли в систему, 405 — метод не разрешён, 404 — не найдено, а 200 с пустым списком — не ошибка. Тестировщик проверяет и код, и данные в базе, и сообщение, которое видит пользователь.
Справка по теме
Группы кодов
Первая цифра кода подсказывает, что произошло. 2xx — успех, 4xx — ошибка клиента (неверный или невыполнимый запрос), 5xx — ошибка сервера.
401 Unauthorized
Сервер не знает, кто отправил запрос: клиент не вошёл в систему или прислал недействительные данные входа. Тестировщик проверяет, что данные не изменились, а пользователь видит понятное сообщение.
405 Method Not Allowed
Адрес существует, но этот метод для него не разрешён.
404 Not Found
Такого ресурса нет: например, товар уже удалён. Сервер ничего не меняет и сообщает, что искомого нет.
200 OK и пустой список
Пустой результат — не ошибка. Запрос выполнен успешно, просто подходящих данных нет. Тестировщик проверяет код 200, пустой список в теле и понятную подсказку для пользователя.