Limites de débit, restrictions et erreurs API

Limites de débit (rate limiting)

Chaque clé API est limitée à un nombre de requêtes par minute, selon votre plan : Starter 60, Business 180, Pro 500, Enterprise 1 200 requêtes/minute. Au-delà, l'API retourne une erreur 429 Too Many Requests avec un en-tête Retry-After (60 secondes) et les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. Les comptes à fort volume peuvent demander une augmentation de cette limite. Pour les envois en masse, l'endpoint bulk accepte jusqu'à 10 000 messages par requête.

Codes de réponse HTTP courants

• 200 OK — requête traitée avec succès
• 400 Bad Request — paramètre manquant ou mal formé (ex. numéro invalide)
• 401 Unauthorized — clé API absente ou invalide
• 402 Payment Required — solde insuffisant
• 429 Too Many Requests — limite de débit dépassée
• 500 Internal Server Error — erreur côté plateforme, contactez le support en indiquant l'heure de la requête et le error.code renvoyé

Bonnes pratiques

• Implémentez une logique de nouvelle tentative (retry) avec backoff exponentiel sur les erreurs 429 et 500
• Loguez systématiquement le message_id retourné pour faciliter tout diagnostic futur
• Utilisez le mode sandbox pour tester votre intégration sans consommer de crédits réels ni envoyer de vrais messages