Rate limiting

Afin de garantir la stabilité et la disponibilité de l'API pour l'ensemble de nos utilisateurs, chaque endpoint de l'API SMS Partner applique une limite de débit (rate limiting). Cette limite définit le nombre maximum de requêtes que vous pouvez effectuer sur un endpoint donné, sur une fenêtre de temps donnée.

Comment ça fonctionne

La limite est appliquée par endpoint et par adresse IP appelante. Chaque endpoint dispose de son propre quota, indépendant des autres : consommer votre quota sur un endpoint n'affecte pas votre quota sur un autre.

Le quota est réinitialisé automatiquement à l'expiration de la fenêtre de temps associée à l'endpoint appelé — il n'y a rien à faire de votre côté pour le réinitialiser.

Les limites exactes (nombre de requêtes autorisées et durée de la fenêtre) varient selon les endpoints, en fonction de leur nature et de leur coût pour notre infrastructure. Si vous avez besoin d'un quota plus élevé pour un cas d'usage spécifique, contactez notre support.

Dépassement de la limite

Lorsque le quota d'un endpoint est dépassé, l'API répond avec le code HTTP 429 Too Many Requests et un corps de réponse JSON de la forme :

{
  "success": false,
  "code": 429,
  "message": "Too many requests, please slow down.",
  "readableLimit": "30 request per 60 secondes"
}

Dans ce cas, aucune action n'est effectuée côté serveur : la requête est simplement rejetée, sans effet de bord.

Headers de réponse

Sur une réponse 429, l'API renvoie également les headers suivants, qui vous permettent de connaître précisément l'état de votre quota :

Header

Description

X-RateLimit-Limit

Nombre maximum de requêtes autorisées sur la fenêtre de temps de l'endpoint

X-RateLimit-Remaining

Nombre de requêtes restantes sur la fenêtre en cours

X-RateLimit-Timeleft

Nombre de secondes avant la réinitialisation du quota

Exemple de réponse complète :

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Timeleft: 42
Content-Type: application/json

{
  "success": false,
  "code": 429,
  "message": "Too many requests, please slow down.",
  "readableLimit": "30 request per 60 secondes"
}

Ces headers ne sont garantis que sur les réponses 429. Ne vous basez pas sur leur présence systématique sur les réponses de succès pour anticiper votre quota restant.

Bonnes pratiques

Respectez X-RateLimit-Timeleft avant de retenter votre requête plutôt que de retenter immédiatement en boucle.
Mettez en place un backoff (délai croissant entre les tentatives) en cas de réponses 429 répétées.
Évitez le polling agressif : privilégiez, quand c'est possible, les webhooks plutôt que l'interrogation régulière d'un endpoint de statut.
Regroupez vos appels lorsque l'endpoint le permet (ex : envoi en masse plutôt que plusieurs appels unitaires), afin de limiter le nombre de requêtes nécessaires.

Besoin d'un quota plus élevé ?

Si les limites par défaut ne conviennent pas à votre volume d'utilisation, contactez notre support en précisant l'endpoint concerné et votre besoin : nous étudierons la possibilité d'ajuster votre quota.

PrécédentWebhooks SuivantCrédits