В этой статье
Что такое коды состояния HTTP?
Коды состояния HTTP — это трёхзначные числа, возвращаемые веб-серверами в ответ на запрос клиента. Они указывают, был ли запрос успешным, перенаправленным, привёл к ошибке или требует дальнейших действий. Каждый раз, когда вы загружаете веб-страницу, ваш браузер получает один из этих кодов.
Коды состояния определены спецификацией HTTP (RFC 7231 и связанные RFC) и сгруппированы в пять классов по первой цифре. Понимание этих кодов необходимо для веб-разработчиков, проектировщиков API и всех, кто отлаживает веб-приложения.
Пять категорий кодов состояния
Коды состояния HTTP организованы в пять категорий, каждая из которых указывает на различный тип ответа.
- 1xx Информационные — запрос получен, обработка продолжается (напр., 100 Continue, 101 Switching Protocols)
- 2xx Успех — запрос успешно получен, понят и принят (напр., 200 OK, 201 Created, 204 No Content)
- 3xx Перенаправление — требуется дальнейшее действие для завершения запроса (напр., 301 Moved Permanently, 302 Found, 304 Not Modified)
- 4xx Ошибка клиента — запрос содержит неправильный синтаксис или не может быть выполнен (напр., 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found)
- 5xx Ошибка сервера — сервер не смог выполнить действительный запрос (напр., 500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable)
Попробуйте бесплатно — без регистрации
Найти коды состояния →Когда использовать справочник кодов состояния HTTP
Знание правильного кода состояния для возврата или ожидания критически важно для построения надёжных веб-сервисов.
- Разработка API — выбрать правильный код ответа для каждого эндпоинта (201 для создания, 204 для удаления, 422 для ошибок валидации)
- Отладка — диагностика проблем при сбое запросов (это проблема аутентификации 401 или авторизации 403?)
- SEO и мониторинг — отслеживать перенаправления 301/302, выявлять битые ссылки 404 и мониторить ошибки сервера 5xx
Часто задаваемые вопросы
В чём разница между 401 и 403?
401 Unauthorized означает, что клиент не предоставил действительных учётных данных для аутентификации — пользователь должен войти в систему или предоставить ключ API. 403 Forbidden означает, что клиент аутентифицирован, но не имеет права доступа к ресурсу. Кратко: 401 = «кто вы?», 403 = «я знаю, кто вы, но у вас нет доступа».
Когда использовать перенаправление 301 или 302?
Используйте 301 Moved Permanently, когда ресурс навсегда перемещён на новый URL — поисковые системы обновят свой индекс. Используйте 302 Found (или 307 Temporary Redirect), когда перенаправление временное и оригинальный URL должен использоваться в будущем. Использование неправильного кода может навредить SEO.
Что означает ошибка 500 Internal Server Error?
Ошибка 500 — это общая ошибка на стороне сервера, указывающая, что при обработке запроса что-то пошло не так, но сервер не может быть более конкретным. Распространённые причины включают необработанные исключения в коде приложения, сбои подключения к базе данных, неправильно настроенные серверы или проблемы с развёртыванием. Проверьте журналы сервера для получения фактических деталей ошибки.