Rate limit e codici di errore

3 min di lettura · API e integrazioni

I rate limit impediscono l'abuso della API. Al superamento ricevi HTTP 429 con l'header Retry-After.

Limiti per piano

Trial / Standard: 60 request / minuto Pro: 300 request / minuto Business: 1000 request / minuto Il limite è per-token, non per-user (puoi avere più token per diversi use case).

Codici di errore

- 401 Unauthorized: token mancante o non valido - 403 Forbidden: il token non ha i permessi per l'azione richiesta (token read-only su endpoint write) - 404 Not Found: la risorsa non esiste - 429 Too Many Requests: rate limit superato, attendi Retry-After secondi - 5xx: server error, retry con exponential backoff

Best practices

- Fai cache delle response in lettura (i dati di uptime non cambiano ogni secondo) - Usa i webhook al posto del polling dove possibile - Per operazioni batch metti un delay tra le request