Co to znaczy
Klient wysłał zbyt wiele żądań w danym czasie (ograniczanie szybkości). Retry-After może podać, ile czekać.
Typowe przyczyny
- Przekroczono limity lub kwoty API
- Pętle ponawiania bez odczekiwania
- Wielu użytkowników za jednym wspólnym IP
Jak naprawić
Jako klient lub odwiedzający
Respektuj Retry-After, stosuj wykładnicze odczekiwanie z losowością, zapamiętuj wyniki i grupuj żądania.
Jako właściciel strony lub API
Zwracaj nagłówki Retry-After i RateLimit, aby klienci mogli się dostosować, i ograniczaj per klucz lub użytkownik, a nie tylko per IP.
Przykładowa odpowiedź
HTTP/1.1
HTTP/1.1 429 Too Many Requests
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Retry-After: 30
RateLimit-Policy: 100;w=60
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Too Many Requests",
"status": 429,
"detail": "Rate limit of 100 requests per minute exceeded."
}Specyfikacja
FAQ
› Jak długo czekać po 429?
Użyj Retry-After, jeśli jest; w przeciwnym razie odczekuj wykładniczo, np. 1, 2, 4, 8 sekund z losowym rozrzutem.
› Czy 429 szkodzi SEO?
Googlebot zwalnia indeksowanie, gdy widzi 429. Krótkie okresy są w porządku; długie mogą opóźnić indeksowanie.