429 Too Many Requests (RFC 6585) oznacza, że użytkownik wysłał zbyt wiele żądań w określonym czasie. Odpowiedź powinna wyjaśniać sytuację i może zawierać nagłówek Retry-After z liczbą sekund lub datą, po której klient może spróbować ponownie. Pamięci podręczne nie mogą przechowywać odpowiedzi 429.
Limity żądań mogą dotyczyć adresu IP, użytkownika, klucza API lub endpointu. Wiele API wysyła też nagłówki, takie jak X-RateLimit-Limit i X-RateLimit-Remaining, albo standaryzowane przez IETF pola nagłówka RateLimit, aby pokazać, ile żądań jeszcze zostało.
Dobrze napisani klienci czekają tak długo, jak wskazuje Retry-After, lub wykładniczo wydłużają odstępy między próbami (exponential backoff), zamiast od razu ponawiać żądanie. Własne API TrueURL również odpowiada kodem 429 z nagłówkiem Retry-After, jeśli w krótkim czasie wykonasz bardzo dużo sprawdzeń.
Przykładowa odpowiedź
HTTP/1.1 429 Too Many Requests
Date: Fri, 06 Nov 2026 10:15:32 GMT
Retry-After: 120
Content-Type: application/json
Content-Length: 81
{"error":"rate_limited","message":"Too many requests. Try again in 120 seconds."}SEO i sprawdzanie przekierowań
Google traktuje 429 jako sygnał przeciążenia serwera, podobnie jak błąd 5xx. Googlebot zwalnia indeksowanie, a adresy URL, które stale zwracają 429, mogą w końcu wypaść z indeksu. Zwracanie 429 lub 503 przez krótki czas to zalecany sposób na awaryjne ograniczenie indeksowania; zwracanie ich dłużej niż przez dzień czy dwa już nie.
Upewnij się, że limity żądań i ochrona przed botami nie uderzają w prawdziwe roboty podczas normalnego działania witryny. Jeśli sprawdzanie przekierowań zwraca 429, serwer docelowy ogranicza liczbę żądań od narzędzia; odczekaj chwilę, zanim sprawdzisz ponownie.
Typowe przyczyny i zastosowania
- Klient API przekroczył swój limit lub limit chwilowych skoków ruchu (burst).
- Formularz logowania blokuje powtarzane próby z tego samego adresu IP.
- Reguła ograniczania liczby żądań w CDN lub WAF zostaje uruchomiona przez robota, narzędzie monitorujące lub narzędzie do masowego sprawdzania.
- Wielu użytkowników korzysta z jednego adresu IP (sieć firmowa, operator komórkowy) i razem przekracza limit na adres IP.