Limity i kwoty

Stawka wymusza dwa limity dla każdego zapytania uwierzytelnionego kluczem:

• Limit na minutę — chroni przed atakami burst.
• Kwotę miesięczną — mierzy łączne użycie na potrzeby rozliczeń.

Oba są liczone w obrębie organizacji. Wiele kluczy należących do tej samej organizacji współdzieli te same kubełki.

Plany

Plan	Zapytań / minutę	Zapytań / miesiąc
Free	5	200
Hobby	600	50 000
Pro	6 000	2 000 000

Plan wynika z aktualnej subskrypcji Twojej organizacji (lub jest free dla organizacji bez aktywnej subskrypcji). Zmiana planu przez Portal Klienta Stripe przełącza limit przy kolejnym zapytaniu — cache stanu klucza jest unieważniany w momencie nadejścia webhooka subskrypcji, więc nie musisz czekać na wygaśnięcie TTL.

Gdy trafisz w limit na minutę

HTTP/1.1 429 Too Many Requests
Retry-After: 23
content-type: application/json

{ "error": "RATE_LIMITED" }

Retry-After to liczba sekund do momentu, gdy bieżący kubełek minutowy zostanie zresetowany. Wycofaj się i spróbuj ponownie.

Gdy trafisz w kwotę miesięczną

HTTP/1.1 429 Too Many Requests
Retry-After: 198473
X-Quota-Limit: 50000
X-Quota-Remaining: 0
content-type: application/json

{ "error": "QUOTA_EXCEEDED" }

Retry-After to liczba sekund do początku kolejnego miesiąca w strefie CET (Europe/Warsaw, z uwzględnieniem czasu letniego). Dwa nagłówki X-Quota-* informują o limicie i o tym, ile jeszcze zostało (zawsze 0 w odpowiedzi z przekroczoną kwotą, ale pojawiają się także w udanych odpowiedziach blisko limitu).

Trafienia w cache są darmowe

Odpowiedzi /rates i /fx są cache’owane na edge’u na maksymalnie jedną godzinę plus okno stale-while-revalidate. Odpowiedzi obsłużone z cache’u edge’a nie zużywają Twojego limitu zapytań ani kwoty — liczą się tylko zapytania, które faktycznie docierają do workera Stawki. W praktyce oznacza to, że nawet zajęty klient odpytujący /rates raz na minutę zużywa znacznie mniej niż 1440 jednostek kwoty dziennie.

Odpowiedzi /vies/* również są cache’owane, ale per para (country, vat) — ponowna walidacja tego samego numeru VAT jest darmowa w obrębie TTL cache’u.