Limity i kwoty
Limity, z którymi porównywane jest każde żądanie, i nagłówki, które podają twoją kwotę.
Nagłówki limitu zapytań
Udane wywołanie optymalizacji zwraca X-RateLimit-Limit (miesięczny limit KONTA — wszystkie klucze konta dzielą jeden) oraz X-RateLimit-Remaining (liczba wywołań pozostałych kontu w tym miesiącu, już po tym wywołaniu). Wysyłają je wyłącznie endpointy optymalizacji: licznik jest rezerwowany w ramach autoryzacji obliczeń, więc /v1/usage i /v1/health nie mają o czym raportować.
| Pole | Typ | Opis |
|---|---|---|
| X-RateLimit-Limit | integer | The ACCOUNT's monthly quota, not this key's: api_authorize compares the month's calls summed over EVERY key on the account against the largest monthly_quota frozen onto any of its ACTIVE keys (migrations 049 + 053). It is the same number GET /v1/usage returns as limit. More keys do not add allowance. On an answer to the public demo key (X-CutOptim-Demo: true) it is instead the per-address DAILY demo allowance. |
| X-RateLimit-Remaining | integer | Calls left on the ACCOUNT in the current UTC calendar month AFTER this one — account-wide for the same reason X-RateLimit-Limit is. Sent only on a successful optimize: the counter is reserved as part of authorizing the request, so /v1/usage and /v1/health have nothing to report. On a demo answer: demo calls left today from this address. |
| Retry-After | integer | Sent with 402 and 409 and 429 only. 402: Seconds until the quota resets — i.e. until 00:00 UTC on the 1st of next month. 409: Sent with idempotency_in_progress: seconds to wait before retrying. 429: Seconds to wait before retrying. |
| X-CutOptim-Demo | "true" | Present, with the value true, only on an answer to the public demo key — refusals included. The demo key has no account: its 200s carry one extra warnings line saying so, and the two X-RateLimit-* headers count the per-address daily demo allowance. |
| Idempotency-Replayed | "true" | Present, with the value true, only when this answer is a stored one returned for a repeated Idempotency-Key. The body and the X-RateLimit-* values are those of the first answer. |
Limity
- 2,000 elementów na zapytanie (łączna ilość, po rozwinięciu qty)
- 50 wierszy materiału bazowego · treść zapytania do 1 MB
- include "pdf": najwyżej 500 części na żądanie (łączna ilość)
- 10 aktywnych kluczy na konto — dzielą JEDEN miesięczny limit: klucze oddzielają środowiska i integracje, nie zwiększają puli
- 10 MB treści żądania na dwóch ścieżkach nest, które mogą nieść rysunek (/v1/optimize/nest i /v1/import/nest); jeden plik source najwyżej 4 000 000 znaków, 8 000 000 na żądanie
- współbieżność jest ograniczona po stronie serwera — obliczenia idą pojedynczo za krótką kolejką (ok. 8 s); burst ponad nią dostaje 429, a odrzucone żądanie nigdy nie jest naliczane. Endpointy validate bez klucza mają dodatkowo limit na adres (429 z Retry-After); z działającym kluczem nigdy nie ma takiego dławienia.
Adres, który w ciągu minuty wyśle ponad 30 nieznanych kluczy API, dostaje 429 do końca tej minuty — jeszcze przed sprawdzeniem klucza. Konto może mieć jednocześnie 5 zadań max w stanie queued/running.
- Idempotency-Key: 8–128 znaków z A-Z a-z 0-9 _ -; klucz i zapisana odpowiedź są przechowywane przez 24 h, osobno dla każdego konta i typu klucza (testowy lub produkcyjny); publiczny klucz demo ignoruje ten nagłówek
- webhooki: najwyżej 5 endpointów na konto; odpowiedź w ciągu 10 s, inaczej doręczenie jest ponawiane — 8 prób w ciągu 24 h; dziennik doręczeń jest przechowywany 30 dni
Czy któryś silnik nie działa? Strona statusu pokazuje na żywo stan witryny, Engine API, silnika nestingu i asynchronicznego silnika max: Status usługi ↗