Limiti e quote
I limiti con cui si confronta ogni richiesta e gli header che riportano la tua quota.
Header del rate limit
Una chiamata di ottimizzazione riuscita riporta X-RateLimit-Limit (il limite mensile dell’ACCOUNT: tutte le chiavi dell’account ne condividono uno solo) e X-RateLimit-Remaining (le chiamate rimaste all’account per il mese in corso, già al netto di questa). Vengono inviati solo dagli endpoint di ottimizzazione: il contatore viene riservato come parte dell’autorizzazione di una risoluzione, quindi /v1/usage e /v1/health non hanno nulla da riportare.
| Campo | Tipo | Descrizione |
|---|---|---|
| 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. |
Limiti
- 2,000 pezzi per richiesta (quantità totale, dopo l’espansione di qty)
- 50 righe di materiale · corpo della richiesta fino a 1 MB
- include "pdf": al massimo 500 pezzi per richiesta (quantità totale)
- 10 chiavi attive per account — condividono UN’UNICA quota mensile: le chiavi separano ambienti e integrazioni, non aumentano il monte
- 10 MB di corpo della richiesta sui due percorsi nest che possono trasportare un disegno (/v1/optimize/nest e /v1/import/nest); un file source al massimo 4.000.000 di caratteri, 8.000.000 per richiesta
- la concorrenza è limitata lato server — le risoluzioni girano una alla volta dietro una coda breve (circa 8 s); un burst oltre questa riceve 429, e una richiesta rifiutata non viene mai addebitata. Gli endpoint validate senza chiave hanno inoltre un tetto per indirizzo (429 con Retry-After); con una chiave valida non si viene mai limitati così.
Un indirizzo che invia più di 30 chiavi API sconosciute in un minuto riceve 429 per il resto di quel minuto, prima di qualsiasi verifica della chiave. Un account può tenere 5 lavori max in queued/running contemporaneamente.
- Idempotency-Key: da 8 a 128 caratteri tra A-Z a-z 0-9 _ -; la chiave e la risposta salvata restano per 24 ore, per account e tipo di chiave (test o live); la chiave demo pubblica ignora l’intestazione
- webhook: fino a 5 endpoint per account; rispondere entro 10 s, altrimenti la consegna viene ritentata — 8 tentativi in 24 ore; il registro delle consegne resta 30 giorni
Un motore è fermo? La pagina di stato mostra in tempo reale lo stato del sito, della Engine API, del motore di nesting e del motore asincrono max: Stato del servizio ↗