Каждый разработчик ведет мысленный шорт-лист кодов статуса HTTP. Раньше мой был 200, 404, и 500, и в течение длительного времени, что было достаточно, чтобы подделать компетентность. Затем я потратил неделю на построение интеграции платежей, где API вернул 402 для отклоненной карты, 409, когда я повторно попробовал заряд, который уже прошел, и 429, когда мои тесты слишком быстро его взломали. Внезапно разница между кодами была разница между рабочей функцией и билетом поддержки. Я создаю много веб-инструментов для Toolz.dev, а ссылка на код состояния с возможностью поиска - это одна из тех вещей, к которым я постоянно обращаюсь, поэтому я встроил ее на сайт и написал это руководство, чтобы использовать ее.
TL;DR: Код состояния HTTP - это трехзначное число, которое сервер отправляет обратно для описания результата запроса. первая цифра задает класс: 1xx информационный, 2xx успех, 3xx перенаправление, 4xx ошибка клиента, 5xx ошибка сервера. Посмотрите любой из них мгновенно с помощью Инструмент кодов состояния HTTP, который позволяет вам искать по номеру, имени или ключевому слову и ссылается на RFC, определяющий каждый из них.
Это руководство рассказывает о том, что такое коды состояния, что означает каждый класс, конкретные коды, которые стоит запомнить, и те, которые люди чаще всего ошибаются. Он предназначен для внешних разработчиков, отлаживающих вызовы API, серверных разработчиков, решающих, что вернуть, и всех, кто выполняет техническое SEO, которым для поведения необходимы перенаправления.
Что такое код состояния HTTP?
Каждый раз, когда ваш браузер или приложение запрашивает что-то через Интернет, сервер отвечает ответом.Первая строка этого ответа содержит код состояния: трехзначное число, в сочетании с короткой фразой причины, такой как & quot;OK& quot; или & quot;Not Found& quot;.Код - это машиночитаемое резюме произошедшего, а фраза причины - удобная для человека метка. Клиенты действуют на число; фраза предназначена для людей, читающих журналы.
Коды состояния определяются Инженерной группой Интернета, в первую очередь в RFC 9110, которая объединила старые спецификации HTTP в 2022 г. В центральном реестре, который ведет IANA, перечислены все официально признанные коды. Эта стандартизация позволяет браузеру, написанному одной компанией, разговаривать с сервером, написанным другой, и договариваться о том, что означает 404.The Инструмент кодов состояния HTTP отражает этот реестр, перечисляя каждый стандартный код по его значению и RFC, который его определяет.
Ключевая ментальная модель заключается в том, что первая цифра сообщает вам категорию, а категория говорит вам, кто несет ответственность. 4xx код означает, что клиент отправил что-то не так. 5xx код означает, что сервер не выполнил по запросу, который был в порядке. это единственное различие разрешает большинство аргументов отладки о том, чья это ошибка.
Что означают пять классов кода состояния?
Классов ровно пять, сгруппированных по ведущей цифре Понимание класса дороже запоминания отдельных кодов, потому что подсказывает, где искать.
Класс 1xx является информационным Эти коды сигнализируют о том, что сервер получил запрос и обработка продолжается Они редки в повседневной работе, Самая известная - 100 Continue, а самая полезная современная - 103 Early Hints, которая позволяет серверу сказать браузеру, чтобы начать предварительную загрузку ресурсов, прежде чем будет готов полный ответ.
Класс 2xx означает успех Запрос был получен, понят и принят. 200 OK - это код повседневного успеха, 201 Created подтверждает, что был создан новый ресурс, и 204 No Content говорит & quot;done, нечего отправить обратно & quot; что является обычным для операций удаления.
Класс 3xx - это перенаправление Ресурс живет где-то еще, или не изменился с тех пор, как клиент видел его в последний раз, В этом классе живет SEO, потому что 301 и 302 сообщают поисковым системам, является ли перемещение постоянным. 304 Не изменено - это рабочая лошадка кэширования, которая экономит огромную пропускную способность.
Класс 4xx - это ошибка клиента. Запрос был искажен, несанкционирован или направлен на то, чего не существует. Здесь живут 400, 401, 403, 404 и 429. Когда вы увидите 4xx, проверьте, какой ваш код отправлен, прежде чем обвинять сервер.
Класс 5xx - ошибка сервера Запрос был действителен, но сервер не смог его выполнить. 500, 502, 503 и 504 - это те, с которыми вы встретитесь в производственных инцидентах, обычно указывающие на сбой, перегруженность службы или нарушение зависимости от восходящего потока.
Какие коды состояния HTTP должен знать каждый разработчик?
Вам не нужны все шестьдесят с лишним кодов в вашей голове Вам нужно может быть пятнадцать, а остальные вы смотрите вверх Вот рабочий набор, я думаю, зарабатывает постоянное место в памяти, с ситуациями, которые их запускают.
| Код | смысл | Когда ты это увидишь |
|---|---|---|
| 200 | ОК | Нормальный удачный запрос |
| 201 | Созданный | ПОСТ или ПУТ создали новый ресурс |
| 204 | Нет контента | Успех с пустым телом, распространенным после УДАЛЕНИЯ |
| 301 | Переехал навсегда | URL-адрес перемещался навсегда; Переводы рейтинга SEO |
| 302 | Найден | Временное перенаправление; продолжайте использовать старый URL-адрес |
| 304 | Не модифицирован | Кэшированная копия по-прежнему действительна; тело не отправлено |
| 400 | Плохой запрос | Неправильный синтаксис или неверный фрейминг запроса |
| 401 | Несанкционированный | Аутентификация отсутствует или не удалась |
| 403 | Запрещенный | Аутентифицировано, но не разрешено |
| 404 | Не найдено | Ресурса не существует |
| 409 | Конфликт | Запрос противоречит текущему состоянию |
| 422 | Необрабатываемый контент | Допустимый синтаксис, правила проверки сбой |
| 429 | Слишком много запросов | Ставка ограничена; отступить и повторить попытку |
| 500 | Внутренняя ошибка сервера | Неожиданный сбой сервера |
| 503 | Сервис Недоступный | Сервер перегружен или находится в обслуживании |
Остальную часть реестра, от 226 IM Used до 451 Unable For Legal Reasons, стоит распознавать, но не запоминать. Именно для этого и нужен инструмент поиска.
В чем разница между 401 и 403?
Эта пара спотыкается почти всех, поэтому она заслуживает своего раздела. оба означают, что доступ был запрещен, но по разным причинам, и разница меняет то, как ваше приложение должно реагировать.
401 Unauthorized означает, что запрос не имеет действительной аутентификации. сервер не знает, кто вы. Либо вы не отправили учетные данные, либо те, которые вы отправили, были неправильными или истекли. правильный ответ с вашей стороны - войти в систему или обновить токен. по спецификации, ответ 401 должен включать заголовок WWW-Authenticate, рассказывающий клиенту, как пройти аутентификацию.
Запрещенный 403 означает, что сервер точно знает, кто вы, и в любом случае отказывается. вы прошли проверку подлинности, но не авторизованы для этого конкретного ресурса. повторный вход в систему не поможет, потому что проблема в разрешениях, а не в идентичности. обычный пользователь, нажимая на конечную точку только для администратора, должен получить 403.
Быстрое правило, которое я использую: 401 - это & quot; кто вы? & quot;, 403 - это & quot;Я знаю, кто вы, и no & quot;. Если вы создаете API и хотите сгенерировать заголовки Авторизация для проверки этих потоков, Базовый генератор авто создает необходимые вам закодированные учетные данные.
Почему перенаправления 301 против 302 имеют значение для SEO?
Перенаправления - это когда коды состояния перестают быть внутренней деталью реализации и начинают влиять на ваш рейтинг в поиске. Когда вы перемещаете страницу, возвращаемый вами код состояния сообщает поисковым системам, что делать со старым URL's накопленным авторитетом.
301 Moved Permanently сигнализирует, что ход окончательный Поисковые системы с течением времени отбрасывают старый URL-адрес из своего индекса, передают сигналы ранжирования на новый URL-адрес и обновляют свои ссылки. это код, который вы хотите, когда переименовываете страницу, переходите на HTTPS или консолидируете дубликаты URL-адресов. Правильное его использование является одним из наиболее распространенных исправлений в техническом SEO-аудите.
302 Found сигнализирует о временном перемещении Поисковые системы сохраняют исходный URL-адрес индексированным, потому что вы сказали им, что изменение не является постоянным. если вы используете 302 для перемещения, которое является постоянным, вы можете заблокировать свой рейтинг на URL-адресе, который вы больше не используете. Я видел, как сайты теряли видимость в течение нескольких месяцев, потому что фреймворк по умолчанию перенаправляет 302 во время миграции HTTPS.
Есть также 307 Временное перенаправление и 308 Постоянное перенаправление, которые ведут себя как 302 и 301, но гарантируют сохранение метода и тела HTTP. Используйте 307 и 308 для запросов, не связанных с GET, где изменение метода может сломать ситуацию. Если вы проверяете, как сканеры видят ваш сайт, соедините эти знания с Роботы.txt Генератор и тот Генератор метатегов чтобы убедиться, что все изображение сканирования и перенаправления согласовано. The Набор инструментов для веб-разработчиков гид связывает эти детали вместе.
Какие коды ошибок сервера являются наиболее распространенными и как их отладить?
Класс 5xx - это место, где происходят производственные инциденты, и каждый код указывает вам на другой уровень стека. Знание того, что экономит реальное время во время сбоя.
Ошибка 500 внутреннего сервера является общим catch-all.Это означает, что ваш код приложения бросил необработанное исключение или попал в состояние, которое он не мог обработать. исправление почти всегда в ваших собственных журналах. 500 - это сервер, говорящий " что-то сломалось, и у меня нет лучшего слова для этого" поэтому код говорит вам, где искать, но не то, что пошло не так.
502 Bad Gateway и 504 Gateway Timeout оба приходят от сервера, действующего как шлюз или прокси, например балансировщик нагрузки или обратный прокси перед вашим приложением.502 означает восходящий отправленный обратно что-то недействительное, часто потому что ваше приложение разбилось или не работает.504 означает восходящий слишком долго отвечал и шлюз отказался от ожидания. если вы бежите за Nginx, CDN или балансировщик облачной нагрузки, это коды, которые вы увидите, когда вещь за прокси-сервером нездорова.
503 Сервис недоступен означает, что сервер временно не может обрабатывать запрос, обычно потому, что он перегружен или находится в обслуживании. хорошо себя вести 503 ответа включают в себя заголовок Retry-After, сообщающий клиентам, когда вернуться.Отправка 503 во время запланированного обслуживания является правильным, безопасным для SEO способом кратко опустить сайт, поскольку он говорит поисковым системам вернуться позже, а не предполагать, что страницы исчезли. Для более широкого рассмотрения диагностики веб-проблем Инструменты повышения производительности разработчик руководство охватывает более широкий набор инструментов.
А как насчет менее распространенных кодов состояния?
Помимо рабочего набора, реестр содержит длинный хвост кодов, с которыми вы будете время от времени встречаться, и распознавание их экономит сбитые с толку полчаса. Некоторые из них стоят быстрого тура.
В семействе 2xx, 206 Частичный контент обеспечивает возобновляемые загрузки и потоковое видео Когда клиент отправляет заголовок Range запрашивая байты от 500 до 999 файла, сервер отвечает 206 именно этим срезом. так возобновляется приостановленная загрузка вместо того, чтобы начинать заново, и как браузер стремится к середине видео, не извлекая все сначала.
В семействе 4xx, 410 Gone является более сильной, более продуманной версией 404. Где 404 говорит & quot;Я не смог найти его & quot;, 410 говорит & quot;это было здесь, оно навсегда исчезло, перестаньте спрашивать & quot;. Использование 410 для контента, который вы намеренно удалили, помогает поисковым системам отбрасывать его быстрее, чем 404. Другой полезный - 451 Недоступный по юридическим причинам, номер которого является отсылкой к роману Fahrenheit 451, возвращаемому, когда контент блокируется юридическим приказом, таким как удаление или судебный запрет.
Есть также 418 I'm a Teapot, настоящий зарегистрированный код из спецификации April Fools 1998 года, что чайник возвращается, когда его просят сварить кофе. Он не используется для нормального трафика, но в некоторых API он отображается как пасхальное яйцо, и это небольшое напоминание о том, что люди, написавшие эти стандарты, испытывали чувство юмора. В инструменте перечислено все это, чтобы вы могли смотреть на все, на что наткнетесь, не догадываясь.
Как помогает инструмент HTTP Status Codes?
Инструмент намеренно прост, потому что задание простое: у вас есть код или симптом, и вы хотите, чтобы значение было быстрым. вы можете искать по номеру, по причине фразы, как "не найден " или по ключевому слову из описания, как "redirect" или "rate limit" Вы можете фильтровать в один класс, чтобы просматривать только перенаправления или только ошибки сервера. Каждая запись показывает фразу причины, простое объяснение того, когда код применяется, и RFC, который его определяет, так что вы можете подтвердить поведение против первоисточника.
Поскольку весь реестр загружается в вашем браузере, поиск мгновенный и работает в автономном режиме, как только страница открыта. Ничего из того, что вы ищете, никуда не отправляется. Это тот тип ссылки, который я сохраняю на вкладке во время создания API, прямо рядом с Пользовательский агент Парсер для проверки заголовков запросов.
Часто задаваемые вопросы
Каковы пять классов кодов состояния HTTP?
коды состояния HTTP сгруппированы по первой цифре: 1xx информационная, 2xx успех, 3xx перенаправление, 4xx ошибка клиента, и 5xx ошибка сервера Класс с первого взгляда сообщает вам, был ли запрос удачным, был перенаправлен или не удался на стороне клиента или сервера, что обычно достаточно, чтобы знать, где начать отладку.
Что означает код состояния 404?
404 Не найдено означает, что сервер не смог найти запрошенный ресурс URL может быть написан с ошибкой, страница может быть удалена, или ссылка может быть нарушена Это код ошибки клиента, поэтому запрос достиг сервера, но указал на что-то, чего там нет.
В чем разница между 301 и 302 перенаправление?
301 Moved Permanently сообщает клиентам и поисковым системам, что ресурс переместился навсегда, поэтому они обновляют свои ссылки и передают сигналы ранжирования на новый URL-адрес. 302 Found - это временное перенаправление, поэтому исходный URL-адрес следует продолжать использовать для будущих запросов, а поисковые системы сохраняют его индексацию.
Что означает ошибка 500 внутреннего сервера?
Ошибка 500 внутреннего сервера - это общее сообщение, означающее, что сервер попал в неожиданное состояние, с которым он не мог справиться. Это сигнализирует о проблеме на сервере, а не о запросе, поэтому исправление обычно находится в коде приложения или конфигурации, а ваши собственные журналы сервера - это место, где можно искать.
Когда API должен возвращать 400 против 422?
Возврат 400 Плохой запрос, когда сам запрос неверен, например, недействительный JSON или отсутствующий необходимый заголовок. Возврат 422 Необрабатываемый контент, когда синтаксис действителен, но данные не соответствуют бизнес-правилам или правилам проверки, например, уже взятое электронное письмо или значение вне диапазона.
Что такое код 429 Too Many Requests?
Слишком много запросов 429 означает, что клиент отправил слишком много запросов за короткое время и его скорость ограничена. Ответ часто включает в себя заголовок Retry-After, сообщающий клиенту, как долго ждать, прежде чем повторить попытку, и хорошо себя ведущие клиенты соблюдают его с экспоненциальным откатом.
Бесплатно ли использовать ссылку на код состояния HTTP?
Да. инструмент совершенно свободен без регистрации и без ограничений, и он работает в автономном режиме после загрузки страницы, потому что весь список работает в вашем браузере. Ничего из того, что вы ищете, не отправляется на сервер, поэтому его безопасно и быстро использовать во время отладки.
