Ograničenja i kvote
Ograničenja prema kojima se provjerava svaki zahtjev i zaglavlja koja javljaju vašu kvotu.
Zaglavlja ograničenja brzine
Uspješan poziv optimizacije nosi X-RateLimit-Limit (mjesečno ograničenje RAČUNA — svi ključevi računa dijele jedno) i X-RateLimit-Remaining (preostali pozivi računa ovaj mjesec, nakon ovoga). Šalju ih samo endpointi za optimizaciju: brojač se rezervira kao dio autorizacije izračuna, pa /v1/usage i /v1/health nemaju što prijaviti.
| Polje | Tip | 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. |
Ograničenja
- 2,000 dijelova po zahtjevu (ukupna količina, nakon proširenja qty)
- 50 redaka zalihe · tijelo zahtjeva do 1 MB
- include "pdf": najviše 500 komada po zahtjevu (ukupna količina)
- 10 aktivnih ključeva po računu — dijele JEDNU mjesečnu kvotu, pa ključevi razdvajaju okruženja i integracije, ne dodaju dozvolu
- 10 MB tijela zahtjeva na dvije nest rute koje mogu nositi crtež (/v1/optimize/nest i /v1/import/nest); jedna source datoteka najviše 4.000.000 znakova, 8.000.000 po zahtjevu
- konkurentnost je ograničena na poslužitelju — izračuni se izvode jedan po jedan iza kratkog reda čekanja (oko 8 s); burst iznad toga dobiva 429, a odbijeni zahtjev nikad se ne naplaćuje. Validate krajnje točke bez ključa dodatno imaju gornju granicu po adresi (429 s Retry-After); s ispravnim ključem se nikad tako ne ograničava.
Adresa koja u minuti pošalje više od 30 nepoznatih API ključeva dobiva 429 do kraja te minute, prije bilo kakve provjere ključa. Račun može imati 5 max poslova istovremeno u queued/running.
- Idempotency-Key: 8–128 znakova iz A-Z a-z 0-9 _ -; ključ i spremljeni odgovor čuvaju se 24 h, posebno za svaki račun i vrstu ključa (testni ili produkcijski); javni demo ključ zanemaruje zaglavlje
- webhookovi: najviše 5 krajnjih točaka po računu; odgovor unutar 10 s ili se isporuka ponavlja — 8 pokušaja tijekom 24 h; zapisnik isporuka čuva se 30 dana
Je li neki motor pao? Stranica statusa uživo prikazuje stanje web-stranice, Engine API-ja, motora za nesting i asinkronog motora max: Status usluge ↗