Rate limit e codici di errore

Il limite di richieste (rate limit) protegge l'API da sovraccarico e abuso. Se in poco tempo invii troppe richieste, il server risponde con HTTP 429 Too Many Requests con l'intestazione Retry-After, che indica quanti secondi attendere.

Limiti attuali

• Il limite è di 60 richieste al minuto per ogni token. Si applica allo stesso modo a tutti i piani (Trial, Standard, Pro e Business).
• Gli agenti LAN hanno un limite separato di 120 richieste al minuto per ogni agente.
• Il limite viene conteggiato per ogni token separatamente (non per l'intero utente). Se ti serve un tetto complessivo più alto, crea più token per usi diversi (ad esempio uno per CI/CD e uno per la dashboard).

Codici di errore

• 401 Unauthorized - token mancante o non valido.
• 403 Forbidden - l'azione non è disponibile nel tuo piano (ad esempio la creazione di un monitor dopo la scadenza del piano o oltre il limite del tuo piano).
• 404 Not Found - la risorsa indicata (monitor, incidente) non esiste o non vi hai accesso.
• 429 Too Many Requests - limite di richieste superato. Attendi il numero di secondi indicato nell'intestazione Retry-After.
• 5xx - errore lato server. Riprova con un ritardo progressivamente più lungo (exponential backoff - ad esempio 1, 2, 4, 8 secondi).

Consigli pratici

• Memorizza le risposte degli endpoint di lettura in una cache. I dati sulla disponibilità non cambiano ogni secondo, non serve scaricarli così spesso.
• Dove possibile, invece di polling ripetuti usa i webhook - il server ti chiamerà da solo quando si verifica un evento.
• Nelle operazioni in batch inserisci un breve ritardo tra le richieste per non avvicinarti al limite.