Riferimento

Limiti di richieste

I limiti sono per spazio di lavoro, condivisi da ogni chiave API al suo interno, e scalano con il piano.

Limiti per piano

Ogni spazio di lavoro ha un budget al minuto e una finestra di burst: al massimo 2× la frequenza media in ogni 10 secondi. Quello che si esaurisce per primo risponde 429 rate_limited con Retry-After. Il tuo uso dell’app non conta mai nel budget dell’API.

Piano	Al minuto	Burst	Inclusi / mese	Job simultanei
Pro	60	20 / 10 s	4000	2
Business	600	200 / 10 s	12.000	5
Enterprise	su misura	su misura	su misura	su misura

Header di risposta

X-RateLimit-LimitRichieste consentite al minuto per lo spazio di lavoro.

X-RateLimit-RemainingRichieste rimaste nel minuto corrente.

X-RateLimit-ResetSecondi alla fine della finestra di un minuto (non è un orario Unix).

Retry-AfterSu ogni 429: secondi da attendere prima di riprovare.

X-Request-IdL’id della richiesta, presente anche nei corpi degli errori. Indicalo all’assistenza.

Idempotent-Replayedtrue quando la risposta è il replay di una richiesta precedente.

Richieste mensili

Ogni piano include un numero di richieste per mese di calendario (UTC). L’uso è mostrato in Settings → API accanto a latenza e tasso di errore degli ultimi 30 giorni. Superarlo oggi non viene rifiutato; annunceremo qui e nel changelog qualsiasi cambiamento prima che avvenga.

Lavori pesanti

Le esecuzioni in blocco e le esportazioni ZIP girano in background e condividono i lavori simultanei del piano; gli altri attendono in coda. Seguili con il polling o con i webhook bulk.completed ed export.completed invece di interrogare in un ciclo serrato.