Vai al contenuto

Limiti di velocità

Per garantire prestazioni elevate e affidabilità a tutti gli utenti, SMSBAT applica una limitazione della velocità alle richieste API. I limiti di velocità specificano il numero massimo di chiamate API che puoi effettuare in un determinato intervallo di tempo.

Limiti predefiniti

Se non diversamente specificato nel contratto, i limiti di velocità predefiniti vengono applicati a tutti gli endpoint API (API SMSBAT, API Cascade e API ChatHub).

Categoria API Limite predefinito Limite di scoppio
Endpoint di messaggistica (/bat/messagelist) 100 richieste/secondo 150 richieste/secondo
Endpoint dati (stato, saldo, informazioni) 50 richieste/secondo 75 richieste/secondo

[!NOTA] Per la messaggistica in uscita (ad esempio, POST /bat/messagelist), una richiesta HTTP può contenere fino a 5.000 messaggi nell'array messages. Il limite di velocità si applica al numero di richieste HTTP, non al numero di messaggi inviati.

Gestione dei limiti di velocità

Se superi il limite di velocità consentito, l'API risponderà con un codice di stato HTTP "429 Too Many Requests".

Esempio di risposta

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please wait before sending more requests.",
  "status": 429
}

Migliori pratiche

Per evitare limitazioni di velocità, prendi in considerazione le seguenti best practice:

  1. Batch i tuoi messaggi: invece di inviare 1.000 richieste HTTP separate per 1.000 messaggi SMS, invia una singola richiesta contenente un array di 1.000 oggetti.
  2. Implementa il backoff esponenziale: se ricevi un codice di stato "429", attendi un breve periodo (ad esempio 1 secondo) e riprova. Se fallisce nuovamente, raddoppia il tempo di attesa (2s, 4s, 8s, ecc.).
  3. Stimolare le tue richieste: se stai eseguendo uno script automatizzato che attiva migliaia di chiamate API, inserisci un piccolo ritardo (ad esempio, sleep(10) millisecondi) tra le richieste.

Richiesta di aumento del limite

Se il tuo caso d'uso richiede un throughput più elevato rispetto ai limiti predefiniti, puoi richiedere un aumento.

  1. Contatta il tuo account manager dedicato o invia un'e-mail a [email protected].
  2. Fornisci il tuo ID account e il throughput previsto (ad esempio, 500 richieste al secondo).
  3. Descrivi brevemente il tuo caso d'uso.

Il nostro team tecnico esaminerà la tua richiesta e adeguerà i tuoi limiti di conseguenza.