Limity zapytań
Limity według planu
Każdy obszar roboczy ma budżet na minutę i okno zrywu: co najwyżej 2× średniego tempa w dowolnych 10 sekundach. Ten, który skończy się pierwszy, odpowiada 429 rate_limited z Retry-After. Twoje własne korzystanie z aplikacji nigdy nie wlicza się do budżetu API.
| Plan | Na minutę | Burst | W cenie / miesiąc | Zadania naraz |
|---|---|---|---|---|
| Pro | 60 | 20 / 10 s | 4000 | 2 |
| Business | 600 | 200 / 10 s | 12 000 | 5 |
| Enterprise | indywidualnie | indywidualnie | indywidualnie | indywidualnie |
Nagłówki odpowiedzi
X-RateLimit-LimitLiczba żądań dozwolonych na minutę dla obszaru roboczego.X-RateLimit-RemainingŻądania pozostałe w bieżącej minucie.X-RateLimit-ResetSekundy do wyzerowania okna minutowego (to nie czas Unix).Retry-AfterPrzy każdym 429: sekundy oczekiwania przed ponowieniem.X-Request-IdIdentyfikator żądania, także w treściach błędów. Podaj go pomocy technicznej.Idempotent-Replayedtrue, gdy odpowiedź jest powtórką wcześniejszego żądania.Żądania miesięczne
Każdy plan zawiera określoną liczbę żądań na miesiąc kalendarzowy (UTC). Zużycie jest widoczne w Settings → API obok opóźnienia i odsetka błędów z ostatnich 30 dni. Przekroczenie nie jest dziś odrzucane; każdą zmianę ogłosimy najpierw tutaj i w changelogu.
Ciężka praca
Uruchomienia zbiorcze i eksporty ZIP działają w tle i dzielą jednoczesne zadania planu; kolejne czekają w kolejce. Śledź je odpytywaniem lub webhookami bulk.completed i export.completed, zamiast odpytywać w ciasnej pętli.