503 Service Unavailable ("сервис недоступен")

https://httpcat.ru/503

Это прямая ссылка на изображение со статусом. Вы можете скопировать и использовать её где угодно.

Описание

Код состояния 503 Service Unavailable означает, что сервер временно не может обработать запрос из-за перегрузки, обслуживания или других временных причин. Это не ошибка клиента, и проблема, как правило, разрешима через некоторое время.

Основные характеристики:

Означает, что сервер работает, но не готов принять запросы в текущий момент
Часто используется при техническом обслуживании, рестарте, развертывании обновлений, перегрузке ресурсов
Может сопровождаться заголовком Retry-After, указывающим, через сколько секунд повторить попытку

Типичное использование:

GET /api/orders HTTP/1.1
Host: example.com

HTTP/1.1 503 Service Unavailable
Retry-After: 120
Content-Type: application/json

{
    "error": "Service temporarily unavailable",
    "message": "Server is undergoing maintenance. Please try again in 2 minutes."
}

Особенности заголовков:

Retry-After — (опционально) указывает клиенту, когда можно повторить запрос
Content-Type — используется для возврата сообщения об ошибке в читаемом формате

Когда использовать:

При техническом обслуживании сервера или базы данных
Если система перегружена и не справляется с текущей нагрузкой
Во время планового (или экстренного) отключения компонентов

Дополнительно:

503 сигнализирует, что проблема временная и не требует изменения на стороне клиента
Не следует использовать для постоянных отказов — для этого подходят другие коды (например, 500 или 403)
Серверы и API-шлюзы могут автоматически возвращать 503 при превышении лимитов или отключении бэкенда

Документация: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/503