Чем отличаются 400, 401, 403, 404, 409, 422 и 429?
На этой странице
Эти status codes описывают разные ошибки клиента: плохой запрос, отсутствие authentication, запрет доступа, отсутствие ресурса, конфликт состояния, ошибку бизнес-валидации и rate limit.
Вопрос
Чем отличаются 400, 401, 403, 404, 409, 422 и 429? Как frontend должен обрабатывать каждый из них?
Быстрая таблица
| Код | Значение | Пример |
|---|---|---|
400 | request невозможно корректно разобрать | битый 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 json400 подходит, когда 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: 60429 означает rate limit. Frontend может показать сообщение и повторить запрос позже.
Что важно помнить
401обычно сопровождается headerWWW-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.