|
Professor Seleznov
|
Всем привет! Я решил сделать для вас шпаргалку с основными статус-кодами протокола HTTP/HTTPS. Для более подробного погружения в тему рекомендую прочитать RFC 9110, который регламентирует статус коды и весь протокол.
Разновидности статус кодов
❓ Что такое status code или коды состояния ответа?
Код состояния ответа — это трёхзначный целочисленный код, описывающий результат запроса и семантику ответа, включая информацию об успешности запроса и его содержимом (если таковое имеется). Все допустимые коды состояния находятся в диапазоне от 100 до 599 включительно.
Первая цифра кода состояния определяет класс ответа. Последние две цифры не имеют никакого отношения к классификации.
Первая цифра может принимать пять значений:
- 1xx (Информационное сообщение): запрос получен, процесс продолжается
- 2xx (Успешно): запрос был успешно получен, понят и принят
- 3xx (Перенаправление): для завершения запроса необходимо предпринять дополнительные действия
- 4xx (Ошибка клиента): запрос содержит некорректный синтаксис или не может быть выполнен
- 5xx (Ошибка сервера): сервер не смог выполнить, по‑видимому, действительный запрос
Важное уточнение: коды состояния HTTP являются расширяемыми. Клиент не обязан понимать значение всех зарегистрированных кодов состояния, хотя такое понимание желательно.
Однако клиент ОБЯЗАН понимать класс любого кода состояния, определяемый первой цифрой, и рассматривать нераспознанный код состояния как эквивалентный коду состояния x00 этого класса.
Иногда используют статус коды вне диапазона 100-599 (например, 600-999), но они используются для внутренней связи не связанной с HTTP/HTTPS, например, ошибка конкретной библиотеки. Клиент такую ошибку может приравнивать к 5xx (Ошибка сервера).
Некоторые статус коды являются эвристически кэшируемыми (например, 200, 203, 204, 206, 300, 301, 308, 404, 405, 410, 414 и 501), то есть браузер кэширует ответ с ними, даже если это не указано явно.
📎 Что такое URI, URL и URN?
В документации встречается аббревиатура URI, кратко разберём что это такое сразу.
- URI (Uniform Resource Identifier) — это компактная последовательность символов, идентифицирующая абстрактный или физический ресурс. Он включает в себя URN и URL.
- URL (Uniform Resource Locator) — это тип URI, который идентифицирует ресурс через описание способа его нахождения (протокол и так далее).
- URN (Uniform Resource Name) — это тип URI, который должен оставаться глобально уникальным и постоянным (имя ресурса, ISBN книг).
⚡️ Наиболее используемые статус коды
1xx (Информационные)
- 100 (Continue, продолжить) — сервер получил начальную часть запроса и ждёт недостающих данных, чтобы дать окончательный ответ клиенту.
- 101 (Switching Protocols, переключение протокола) — сервер понимает и готов выполнить запрос клиента, поступающий через поле заголовка Upgrade, об изменении используемого протокола приложения в данном соединении (так происходит переход с HTTP на websocket).
2xx (Успешные)
- 200 (Ok, успех) — запрос выполнен успешно, обычно есть содержимое в ответе.
- 201 (Created, создано) — запрос выполнен и в результате создан один или несколько новых ресурсов, содержимое ответа обычно содержит этот ресурс.
- 202 (Accepted, принято) — запрос принят к обработке, но обработка еще не завершена.
- 203 (Non-authoritative information, неавторитетная информация) — запрос был успешным, но содержимое было изменено по сравнению с ответом исходного сервера 200 (OK) преобразующим прокси-сервером.
- 204 (No content, нет содержимого) — сервер успешно выполнил запрос и в ответе нет дополнительного содержимого для отправки.
- 205 (Reset content, сброс содержимого) — сервер выполнил запрос и желает, чтобы пользовательский агент сбросил «представление документа», которое вызвало отправку запроса, до его исходного состояния, полученного от исходного сервера.
- 206 (Partial content, частичное содержание) — сервер успешно выполняет запрос диапазона для целевого ресурса, передавая одну или несколько частей выбранного представления.
3xx (Перенаправление)
- 300 (Multiple choices, множественный выбор) — указывает на то, что целевой ресурс имеет более одного представления, каждое со своим более конкретным идентификатором, и предоставляется информация об альтернативах.
- 301 (Moved permanently, перемещено навсегда) — указывает на то, что целевому ресурсу присвоен новый постоянный URI.
- 302 (Found, найдено) — указывает на то, что целевой ресурс временно находится по другому URI.
- 303 (See Other, смотри другое) — сервер перенаправляет пользовательский агент на другой ресурс, как указано в поле заголовка Location.
- 304 (Not Modified, не изменено) — указывает на то, что у нас и так актуальная версия ресурса и нет надобности сервера отправлять его снова.
- 307 (Temporary redirect, временное перенаправление) — целевой ресурс временно находится под другим URI, и пользовательский агент НЕ ДОЛЖЕН изменять метод запроса.
- 308 (Permanent redirect, постоянное перенаправление) — аналог 301, но с гарантией неизменности методов.
4xx (Ошибка клиента)
- 400 (Bad Request, неверный запрос) — сервер не может обработать запрос из-за ошибки клиента (например, если не подходит к pydantic схеме).
- 401 (Unauthorized, не авторизован) — запрос не выполнен, так как отсутствуют действительные учётные данные. (Кидаю её, если пользователь дёргает ручку без токена или с невалидным токеном).
- 403 (Forbidden, запрещено) — сервер понял запрос, но отказался его выполнить. (Кидаю, когда пользователь пытается редактировать не свой профиль).
- 404 (Not Found, не найдено) — сервер не обнаружил ресурс.
- 405 (Method not allowed, метод не разрешен) — метод известен серверу, но не применим к этому ресурсу.
- 408 (Request Time-out, тайм-аут запроса) — сервер не получил полный запрос в течение времени ожидания.
- 409 (Conflict, конфликт) — запрос не выполнен из-за конфликта с текущим состоянием ресурса. (Кидаю, когда пользователь с таким именем уже есть).
5xx (Ошибка сервера)
- 500 (Внутренняя ошибка сервера) — исключительная ситуация на сервере.
- 503 (Сервис недоступен) — сервер не может обработать запрос из-за перегрузки или тех. обслуживания.
На этом всё, до встречи!-Источник
|
