Retry-After

Применение

Заголовок Retry-After появляется в ответах, когда серверу нужно, чтобы клиент выдержал паузу перед повторной попыткой. Этот заголовок обычно сопровождает три кода состояния:

Заголовок допускает два формата: задержку в секундах (delta-seconds) или абсолютную дату HTTP-date. При использовании секунд значением является неотрицательное целое число, обозначающее количество секунд ожидания. При использовании HTTP-date значение записывается в формате IMF-fixdate.

Добропорядочные клиенты и сканеры соблюдают этот заголовок, чтобы не перегружать восстанавливающийся сервер.

Примечание

Поисковые сканеры воспринимают Retry-After в ответах 503 как сигнал вернуться к URL позже, а не как указание удалить страницу из индекса. И Googlebot, и Bingbot соблюдают этот заголовок при планировании повторных визитов. Во время планового обслуживания возврат 503 Service Unavailable с Retry-After сохраняет индексируемость. Без этого заголовка длительный простой рискует привести к деиндексации.

Delta-seconds

Неотрицательное целое число, задающее количество секунд, которое клиенту нужно подождать перед повторной отправкой запроса.

Retry-After: 120

HTTP-date

Абсолютные дата и время в формате IMF-fixdate, после которых клиент может свободно повторить запрос. Дата указывается в GMT и следует формату Day, DD Mon YYYY HH:MM:SS GMT.

Retry-After: Sat, 31 Oct 2026 18:00:00 GMT

Пример

Сервер, отвечающий 503 во время технического обслуживания, сообщает клиенту подождать 3600 секунд (один час) перед повторной попыткой.

HTTP/1.1 503 Service Unavailable
Retry-After: 3600

Ограничитель частоты запросов API, отвечающий 429, указывает абсолютную дату сброса лимита. Клиент приостанавливает запросы до указанного момента.

HTTP/1.1 429 Too Many Requests
Retry-After: Sat, 31 Oct 2026 12:30:00 GMT

Запланированное перенаправление с кодом 301 включает задержку, чтобы предотвратить шквал немедленных повторных попыток от множества клиентов.

HTTP/1.1 301 Moved Permanently
Location: https://new.example.re/resource
Retry-After: 60

Примечание

Ограничители частоты запросов API часто сочетают Retry-After с заголовками RateLimit-Limit. Заголовок RateLimit-Remaining показывает, сколько запросов осталось в текущем окне, а Retry-After точно сообщает клиентам, когда возобновить работу после ответа 429. Хорошо спроектированные API включают оба заголовка, чтобы клиенты плавно снижали нагрузку, а не долбили ограниченную по частоте конечную точку.