re:re:actable
Урок 063 минуты чтения

Чем отличаются 400, 401, 403, 404, 409, 422 и 429?

На этой странице
Кратко

Эти status codes описывают разные ошибки клиента: плохой запрос, отсутствие authentication, запрет доступа, отсутствие ресурса, конфликт состояния, ошибку бизнес-валидации и rate limit.

Вопрос

Чем отличаются 400, 401, 403, 404, 409, 422 и 429? Как frontend должен обрабатывать каждый из них?

Быстрая таблица

КодЗначениеПример
400request невозможно корректно разобратьбитый JSON
401нет authenticationнет token/session
403нет правuser не admin
404ресурс не найденнет /users/999
409конфликт текущего состоянияemail уже занят
422данные понятны, но невалидны по правиламpassword слишком слабый
429слишком много запросовrate limit

400 Bad Request

POST /api/users
Content-Type: application/json
 
{ bad json

400 подходит, когда request синтаксически или структурно некорректен.

401 Unauthorized

{
  "message": "Authentication required"
}

Название немного сбивает с толку: 401 Unauthorized на практике означает "не authenticated". Клиенту нужно войти, обновить token или отправить credentials.

403 Forbidden

{
  "message": "You do not have permission to access this resource"
}

403 означает: сервер понял, кто пользователь, но действие запрещено.

404 Not Found

404 используют, когда ресурса нет или сервер не хочет раскрывать его существование.

Для приватных ресурсов иногда возвращают 404 вместо 403, чтобы не подсказывать атакующему, что объект существует.

409 Conflict

POST /api/users
 
{
  "email": "taken@example.com"
}

Если email уже занят, это конфликт с текущим состоянием системы. 409 хорошо подходит для unique constraint conflicts, optimistic locking, duplicate idempotency keys.

422 Unprocessable Content

422 подходит, когда JSON корректный, но значения не проходят domain validation.

{
  "email": "not-an-email",
  "password": "123"
}

Некоторые API вместо 422 используют 400 для всей validation. Главное - быть последовательным.

429 Too Many Requests

HTTP/1.1 429 Too Many Requests
Retry-After: 60

429 означает rate limit. Frontend может показать сообщение и повторить запрос позже.

Что важно помнить

  • 401 обычно сопровождается header WWW-Authenticate; на frontend это сигнал обновить access token или отправить на вход.
  • 403 повторять бессмысленно: права не появятся от retry. Показывайте сообщение об отсутствии доступа.
  • 429 нужно обрабатывать с задержкой: уважайте Retry-After и используйте exponential backoff, иначе запросы усугубят ограничение.
  • Ошибки 422 и 409 удобно возвращать с полями (fields), чтобы подсветить конкретный input формы.
  • 404 для чужих приватных ресурсов вместо 403 скрывает сам факт их существования.

Мини-шпаргалка

  • 400 - request плохой.
  • 401 - нужно войти.
  • 403 - вошел, но нельзя.
  • 404 - не найдено.
  • 409 - конфликт состояния.
  • 422 - validation/domain errors.
  • 429 - rate limit.

Документация

MDN: 401 Unauthorized, MDN: 403 Forbidden, MDN: 422 Unprocessable Content, MDN: 429 Too Many Requests.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам