Aller au contenu

Limites de taux

Pour garantir des performances et une fiabilité élevées à tous les utilisateurs, SMSBAT applique une limitation de débit aux requêtes API. Les limites de débit spécifient le nombre maximum d'appels d'API que vous pouvez effectuer dans un délai donné.

Limites par défaut

Sauf indication contraire dans votre contrat, les limites de débit par défaut sont appliquées à tous les points de terminaison de l'API (API SMSBAT, API Cascade et API ChatHub).

Catégorie API Limite par défaut Limite d'éclatement
Points de terminaison de messagerie (/bat/messagelist) 100 requêtes / seconde 150 requêtes / seconde
Points de terminaison des données (état, solde, informations) 50 requêtes / seconde 75 requêtes / seconde

[!NOTE] Pour la messagerie sortante (par exemple, POST /bat/messagelist), une requête HTTP peut contenir jusqu'à 5 000 messages dans le tableau messages. La limite de débit s'applique au nombre de requêtes HTTP, et non au nombre de messages envoyés.

Limites de taux de traitement

Si vous dépassez la limite de débit autorisée, l'API répondra avec un code d'état HTTP « 429 Too Many Requests ».

Exemple de réponse

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

Bonnes pratiques

Pour éviter d'être limité en débit, tenez compte des bonnes pratiques suivantes :

  1. Regroupez vos messages : au lieu d'envoyer 1 000 requêtes HTTP distinctes pour 1 000 messages SMS, envoyez une seule requête contenant un tableau de 1 000 objets.
  2. Mettez en œuvre l'interruption exponentielle : si vous recevez un code d'état « 429 », attendez une courte période (par exemple, 1 seconde) et réessayez. En cas d'échec à nouveau, doublez le temps d'attente (2 s, 4 s, 8 s, etc.).
  3. Ralentissez vos requêtes : si vous exécutez un script automatisé qui déclenche des milliers d'appels d'API, introduisez un petit délai (par exemple, sleep(10) millisecondes) entre les requêtes.

Demander une augmentation de limite

Si votre cas d'utilisation nécessite un débit supérieur aux limites par défaut, vous pouvez demander une augmentation.

  1. Contactez votre responsable de compte dédié ou envoyez un e-mail à [email protected].
  2. Fournissez votre identifiant de compte et le débit attendu (par exemple, 500 requêtes par seconde).
  3. Décrivez brièvement votre cas d'utilisation.

Notre équipe technique examinera votre demande et ajustera vos limites en conséquence.