Что такое коды ответа HTTP — что значат 200, 404 и 500, которые шлёт сервер

Смотри, скрытая штука: каждый раз, когда ты открываешь сайт, сервер отвечает не только страницей, но и трёхзначным числом. Ты его обычно не видишь — но именно оно говорит, что пошло не так.

200, 404, 500 — это коды ответа HTTP. И вот что удобно: по первой цифре сразу понятно, чья вина — твоя или сервера. Через пару минут будешь читать их как светофор.

Что это такое

Когда твой браузер (или приложение) стучится к серверу через API, сервер обязан ответить. К каждому ответу он цепляет короткий код-статус — трёхзначное число.

Это как ответ из справочного окошка. Ты спросил — тебе не просто дали бумажку, а ещё и сказали настроением: «держи, всё нашёл», «такого нет», «я сам сломался, приходи позже». Код — это и есть настроение ответа, сжатое в число.

Текст страницы можно и не читать — по коду уже ясно, удался запрос или нет.

Первая цифра решает всё

Весь фокус в первой цифре. Она делит все коды на пять семей:

• 2xx — успех. Всё получилось. Самый частый гость — 200.
• 3xx — перенаправление. «Тебе не сюда, иди вот туда». Браузер сам перекидывает.
• 4xx — ошибка на твоей стороне. Ты попросил что-то не то: неверный адрес, нет доступа, кривой запрос.
• 5xx — ошибка на стороне сервера. Ты всё сделал правильно — сломался он.

Запомнил это — и половина паники уходит. Видишь 4xx — проверяй свой запрос. Видишь 5xx — дело не в тебе, чини (или жди) сервер.

Коды, которые встретишь чаще всего

• 200 OK — всё хорошо, вот ответ. Так выглядит нормальная жизнь.
• 301 / 302 — страница переехала. 301 — навсегда, 302 — временно.
• 400 Bad Request — сервер не понял запрос: что-то с форматом или данными.
• 401 / 403 — про доступ. 401 — «ты не вошёл», 403 — «вошёл, но сюда нельзя».
• 404 Not Found — по этому адресу ничего нет. Классика битых ссылок.
• 429 Too Many Requests — ты слишком частишь, сбавь темп (привет, лимиты запросов).
• 500 Internal Server Error — сервер упал на своей ошибке. Ты ни при чём.
• 502 / 503 — сервер жив, но сейчас недоступен или перегружен. Часто временно.

Это не весь список, но 90% того, что ты реально встретишь.

Почему тебе это важно

Когда собираешь приложение и оно ходит в чужой API, коды — твой главный диагност.

Запрос вернул 401 — значит забыл или испортил ключ, лезь проверять авторизацию. Вернул 404 — перепутал адрес эндпоинта. Посыпались 429 — бьёшь по API слишком часто, добавь паузу. Прилетел 500 — беги проверять не свой код, а сервер, к которому обращаешься.

Вывод, который стоит унести: код ответа сразу говорит, где искать проблему. 4xx — чини свою сторону, 5xx — чужую. Это экономит часы слепого тыка. Кстати, отдельный разбор самого пугающего есть в ошибка 500 — как чинить, а близкая по духу засада — в ошибка CORS — что делать.

Живой пример. Твой бот перестал получать данные, в логах — 401. Первая цифра «4» кричит: дело в тебе. Смотришь — у ключа кончился срок. Поменял ключ, всё полетело. А будь там 503 — ты бы зря копал свой код: это сервер прилёг, надо подождать или взять другой источник. Код сразу развернул тебя в нужную сторону, не дав потратить час впустую.

Код 200 — это всегда значит «всё правильно»?

Не совсем. 200 значит «запрос дошёл и сервер ответил успешно». Но внутри ответа логика может быть не той, что ты ждал: пустой список, не те данные. 200 — это «связь удалась», а не «результат тебе понравится». Проверяй и код, и само тело ответа.

Чем 401 отличается от 403?

401 — «я не знаю, кто ты»: ты не вошёл или ключ невалиден. 403 — «я знаю, кто ты, но тебе сюда нельзя»: прав не хватает. Первое чинят входом, второе — доступом.

Это только про сайты?

Нет. Те же коды использует почти любой REST API — мобильные приложения, боты, интеграции между сервисами. Открываешь ты страницу или твой бот дёргает чужой сервис — язык ответов один и тот же.

Что делать, если я вижу код, которого нет в списке?

Не паникуй — работает то же правило первой цифры. Незнакомый код на 4xx — чини свой запрос, на 5xx — проблема на сервере. Точное значение гуглится за секунду — по запросу вида «HTTP 429», — но направление ты уже знаешь по первой цифре. Список выше закрывает почти все реальные случаи, остальное — редкие частности.