Limite și cote
Limitele cu care se verifică fiecare cerere și antetele care îți raportează cota.
Headere de limitare a ratei
Un apel de optimizare reușit conține X-RateLimit-Limit (plafonul lunar al CONTULUI — toate cheile contului împart unul singur) și X-RateLimit-Remaining (apelurile rămase contului în luna curentă, după acesta). Sunt trimise doar de endpointurile de optimizare: contorul este rezervat ca parte a autorizării unei rezolvări, deci /v1/usage și /v1/health nu au nimic de raportat.
| Câmp | Tip | Descriere |
|---|---|---|
| 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. |
Limite
- 2,000 piese per cerere (cantitate totală, după expandarea qty)
- 50 rânduri de material · corpul cererii până la 1 MB
- include "pdf": cel mult 500 piese pe cerere (cantitate totală)
- 10 chei active per cont — împart O SINGURĂ cotă lunară: cheile separă mediile și integrările, nu adaugă alocare
- 10 MB corp al cererii pe cele două rute nest care pot transporta un desen (/v1/optimize/nest și /v1/import/nest); un fișier source cel mult 4.000.000 de caractere, 8.000.000 pe cerere
- concurența este limitată pe server — rezolvările rulează pe rând, în spatele unei cozi scurte (circa 8 s); un burst peste ea primește 429, iar o cerere refuzată nu este niciodată taxată. Endpoint-urile validate fără cheie au în plus un plafon per adresă (429 cu Retry-After); cu o cheie validă nu ești niciodată limitat astfel.
O adresă care trimite peste 30 de chei API necunoscute într-un minut primește 429 pentru restul acelui minut, înainte de orice verificare a cheii. Un cont poate avea 5 lucrări max în queued/running simultan.
- Idempotency-Key: 8–128 caractere din A-Z a-z 0-9 _ -; cheia și răspunsul salvat se păstrează 24 de ore, pe cont și pe tip de cheie (test sau producție); cheia demo publică ignoră antetul
- webhookuri: cel mult 5 endpointuri pe cont; răspundeți în 10 s, altfel livrarea se reîncearcă — 8 încercări în 24 de ore; jurnalul livrărilor se păstrează 30 de zile
A căzut un motor? Pagina de stare arată în timp real starea site-ului, a Engine API, a motorului de nesting și a motorului asincron max: Starea serviciului ↗