Retry-After

Utilisation

L’en-tête Retry-After apparaît dans les réponses où le serveur demande au client d’attendre avant de réessayer. Cet en-tête est couramment associé à trois codes de statut :

L’en-tête accepte deux formats : un délai en secondes (delta-seconds) ou une HTTP-date absolue. Avec les secondes, la valeur est un entier non négatif représentant le nombre de secondes à attendre. Avec une HTTP-date, la valeur suit le format IMF-fixdate.

Les clients et robots d’exploration bien conçus respectent cet en-tête afin de ne pas surcharger un serveur en cours de rétablissement.

Remarque

Les robots des moteurs de recherche interprètent Retry-After sur une réponse 503 comme un signal de revenir plus tard sur l’URL plutôt que de retirer la page de l’index. Googlebot et Bingbot respectent tous deux cet en-tête pour planifier leurs visites ultérieures. Pendant une maintenance planifiée, renvoyer 503 Service Unavailable avec Retry-After préserve l’indexabilité. Sans cet en-tête, une indisponibilité prolongée risque d’entraîner une désindexation.

Delta-seconds

Un entier non négatif indiquant le nombre de secondes que le client doit attendre avant de réémettre la requête.

Retry-After: 120

HTTP-date

Une date et une heure absolues au format IMF-fixdate, après lesquelles le client est libre de réessayer. La date est exprimée en GMT et suit le format Day, DD Mon YYYY HH:MM:SS GMT.

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

Exemple

Un serveur qui répond 503 pendant une fenêtre de maintenance indique au client d’attendre 3600 secondes (une heure) avant de réessayer.

HTTP/1.1 503 Service Unavailable
Retry-After: 3600

Un limiteur de débit d’API qui répond 429 fournit une date absolue à laquelle la limite de débit est réinitialisée. Le client suspend ses requêtes jusqu’à l’heure indiquée.

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

Une redirection planifiée avec 301 inclut un délai afin d’éviter des rafales de nouvelles tentatives immédiates provenant de plusieurs clients.

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

Remarque

Les limiteurs de débit d’API associent souvent Retry-After aux en-têtes RateLimit-Limit. L’en-tête RateLimit-Remaining indique combien de requêtes restent disponibles dans la fenêtre courante, tandis que Retry-After indique précisément aux clients quand reprendre après une réponse 429. Les API bien conçues fournissent les deux, afin que les clients lèvent le pied au lieu de marteler un point d’accès soumis à limitation.