← Referenční příručka API
Limity a kvóty
Limity, se kterými se porovnává každý požadavek, a hlavičky, které hlásí vaši kvótu.
Hlavičky rate limitu
Úspěšné volání optimalizace nese X-RateLimit-Limit (měsíční strop ÚČTU — všechny klíče účtu sdílejí jeden) a X-RateLimit-Remaining (kolik volání účtu v tomto měsíci zbývá po tomto). Posílají je pouze optimalizační endpointy: počítadlo se rezervuje jako součást autorizace výpočtu, takže /v1/usage a /v1/health nemají co hlásit.
| Pole | Typ | Popis |
|---|---|---|
| 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 dílů na požadavek (celkové množství, po rozepsání qty)
- 50 řádků materiálu · tělo požadavku až 1 MB
- include "pdf": nejvýše 500 dílů na požadavek (celkové množství)
- 10 aktivních klíčů na účet — sdílejí JEDNU měsíční kvótu: klíče oddělují prostředí a integrace, kvótu nezvyšují
- 10 MB těla požadavku na těch dvou nest cestách, které mohou nést výkres (/v1/optimize/nest a /v1/import/nest); jeden soubor source nejvýše 4 000 000 znaků, 8 000 000 na požadavek
- souběžnost je omezena na straně serveru — výpočty běží jeden po druhém za krátkou frontou (cca 8 s); burst nad ni dostane 429 a odmítnutý požadavek se nikdy neúčtuje. Endpointy validate bez klíče mají navíc strop na adresu (429 s Retry-After); s platným klíčem k takovému škrcení nikdy nedojde. Adresa, která během minuty pošle více než 30 neznámých API klíčů, dostává do konce té minuty 429 — ještě před ověřením klíče. Účet může mít současně 5 úloh max ve stavu queued/running.
- Idempotency-Key: 8–128 znaků z A-Z a-z 0-9 _ -; klíč a uložená odpověď se uchovávají 24 h, zvlášť pro každý účet a typ klíče (testovací nebo ostrý); veřejný demo klíč hlavičku ignoruje
- webhooky: nejvýše 5 endpointů na účet; odpověď do 10 s, jinak se doručení opakuje — 8 pokusů během 24 h; protokol doručení se uchovává 30 dní
Nefunguje některé jádro? Stavová stránka ukazuje živý stav webu, Engine API, nestingového jádra a asynchronního jádra max: Stav služby ↗