Що це означає
Сервер тимчасово не може обробити запит через перевантаження чи обслуговування. Retry-After може вказати, коли спробувати знову.
Типові причини
- Планове обслуговування
- Сервер перевантажений або без вільних worker
- Автомасштабування не встигає або збої залежностей
Як виправити
Якщо ви клієнт або відвідувач
Спробуйте пізніше, дотримуючись Retry-After.
Якщо ви власник сайту чи API
Надсилайте Retry-After під час обслуговування, масштабуйте потужності й плавно скидайте навантаження. Пошукові системи вважають короткі 503 тимчасовими.
Приклад відповіді
HTTP/1.1
HTTP/1.1 503 Service Unavailable
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Retry-After: 120
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Service Unavailable",
"status": 503,
"detail": "Down for maintenance until 02:00 UTC."
}Специфікація
Часті запитання
› Чи підходить 503 для сторінок обслуговування?
Так. Повертайте 503 з Retry-After; тоді пошукові системи збережуть сторінку в індексі, а не вважатимуть її видаленою.
› 503 чи 500?
503 каже, що збій тимчасовий і очікується відновлення; 500 — непередбачена помилка.