Limiti di utilizzo

Per garantire un servizio stabile e veloce a tutti i clienti, l'API Sterna applica un limite al numero di richieste che ogni account può effettuare in un dato intervallo di tempo. Questo meccanismo è noto come rate limiting.

Qual è il limite

Il limite è di 120 richieste al minuto per account. Per la grande maggioranza delle integrazioni questo limite è ampiamente sufficiente e non lo incontrerai mai durante il normale funzionamento.

Cosa succede se superi il limite

Se le tue richieste superano il limite consentito, l'API non le elabora e risponde con il codice di stato HTTP 429 e un errore rate_limit_exceeded. La risposta indica anche dopo quanti secondi puoi riprovare, nel campo retry_after_seconds:

{
  "error": "rate_limit_exceeded",
  "retry_after_seconds": 30
}

Come gestire il limite

Gestire correttamente il rate limiting rende la tua integrazione più robusta. Il comportamento consigliato è semplice:

• Quando ricevi una risposta con codice 429, non riprovare subito.
• Leggi il valore di retry_after_seconds e attendi quel numero di secondi prima di effettuare una nuova richiesta.
• Trascorso quel tempo, puoi riprendere normalmente.

Se prevedi di effettuare molte richieste ravvicinate — per esempio per creare diversi ordini in sequenza — distribuiscile nel tempo invece di inviarle tutte insieme: eviterai di incontrare il limite.