Limity szybkości

Każdy klucz API ma stały limit żądań na sekundę wyprowadzony z Twojego planu (Free 1 req/s → Max 60 req/s — zobacz Ceny). Limity są egzekwowane za pomocą token bucket: serie do Twojej pojemności na minutę są dozwolone, następnie żądania są wygładzane do stałej szybkości.

Gdy zostaniesz ograniczony

{ "error": "rate_limited", "retry_after_ms": 850 }

HTTP 429, error: "rate_limited".
retry_after_ms mówi, ile minimalnie odczekać przed ponowieniem.
Nagłówek x-ratelimit-remaining w każdej odpowiedzi raportuje, ile żądań pozostało w tej minucie.

Współbieżność

Poza szybkością na sekundę istnieje limit żądań w toku. Jeśli wyślesz wiele żądań naraz, możesz zobaczyć:

409 request_in_progress — identyczne idempotentne żądanie już jest w toku.
503 too_many_concurrent_requests — zbyt wiele jednoczesnych żądań w toku; wycofaj się i ponów.

Obsługa limitów

Przestrzegaj retry_after_ms; w przeciwnym razie użyj wykładniczego odczekiwania z jitterem.
Utrzymuj po stronie klienta limit współbieżności dopasowany do szybkości Twojego planu.
Oficjalne SDK ponawiają 429/503 automatycznie.