Przekazywanie limitów klientom API
Dowiedzą się Państwo, jakie konwencje HTTP służą do informowania klientów o limitach zapytań, w tym o kodzie stanu 429, nagłówku Retry-After i nagłówkach RateLimit umożliwiających poprawne zachowanie klientów.
Przekazywanie limitów klientom API to bezpłatna lekcja API Rate Limiting & Scalability Patterns na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej API Rate Limiting & Scalability Patterns, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs API Rate Limiting & Scalability Patterns zawiera 4 lekcji w sumie.
Części tej lekcji nie zostały jeszcze przetłumaczone i są wyświetlane po angielsku.
Limits Need Communication
A limit that silently drops requests frustrates devs. A good API tells clients their usage, when they'll be throttled, and when to retry.
The 429 Status Code
When a client exceeds its allowance, return 429 Too Many Requests — the universal signal that the request was throttled, not a server error.
HTTP/1.1 429 Too Many Requests
Content-Type: application/json
{ "error": "rate_limit_exceeded" }Why Not 503
Don't use 503 or 500 for throttling — they imply the server is broken. 429 is specific: the client's fault, and it's temporary.
The Retry-After Header
Pair a 429 with a Retry-After header — seconds or an HTTP date — and well-behaved clients wait instead of hammering the server.
HTTP/1.1 429 Too Many Requests
Retry-After: 30Proactive Headers
Add proactive headers on successful responses too, reporting remaining quota so clients self-throttle before they ever hit a 429.
RateLimit-Limit: 100
RateLimit-Remaining: 42
RateLimit-Reset: 30Header Naming
Old APIs used X-RateLimit-*; the IETF draft uses unprefixed RateLimit-*. Pick one convention and document it — consistency beats the name.
Reset Semantics
The reset value is either seconds until the window resets or an absolute timestamp. Document which, or clients will retry too early.
A Clear Error Body
Beyond headers, return a structured JSON error body with the limit, what's left, and a human-readable message to aid debugging.
{
"error": "rate_limit_exceeded",
"limit": 100,
"retry_after": 30,
"message": "Slow down and retry in 30 seconds."
}Client-Side Behavior
Good clients read these signals and apply exponential backoff with jitter on a 429 instead of retrying instantly — Retry-After nudges them.
Documenting Limits
Document your limits, header names, and reset semantics. Predictable, published limits let integrators build resilient apps and cut support load.
Putting It Together
The complete response: a 429 status, Retry-After, the RateLimit trio, and a descriptive JSON body — turning a rejection into guidance.
Quick Check
Status code, headers, error body — which signals actually tell clients about the limit?
Recap
Recap: throttle with 429 (not 5xx), add Retry-After, send RateLimit-Limit/Remaining/Reset so clients self-throttle, and document it all.
Ucz się API Rate Limiting & Scalability Patterns dzięki korepetycjom AI — za darmo
Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.
- Kursy
- 12
- Lekcje
- 48
Często zadawane pytania
Czy lekcja „Przekazywanie limitów klientom API” jest bezpłatna?
Tak — pełny tekst „Przekazywanie limitów klientom API” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu API Rate Limiting & Scalability Patterns, przejdź na CoddyKit PRO. Kurs API Rate Limiting & Scalability Patterns zawiera 4 lekcji w sumie.
Co nauczysz się w „Przekazywanie limitów klientom API”?
Dowiedzą się Państwo, jakie konwencje HTTP służą do informowania klientów o limitach zapytań, w tym o kodzie stanu 429, nagłówku Retry-After i nagłówkach RateLimit umożliwiających poprawne zachowanie… Ćwiczysz API Rate Limiting & Scalability Patterns z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć API Rate Limiting & Scalability Patterns?
Nie wymagamy żadnego doświadczenia. API Rate Limiting & Scalability Patterns w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.
Ile czasu zajmuje lekcja „Przekazywanie limitów klientom API”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji API Rate Limiting & Scalability Patterns?
Tak. Każda lekcja API Rate Limiting & Scalability Patterns zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Czym jest ograniczanie przepustowości API?
- Dlaczego ograniczanie przepustowości jest kluczowe
- Podstawowe pojęcia ograniczania przepustowości
- Przekazywanie limitów klientom API