Limites de débit, restrictions et erreurs API

Limites de débit (rate limiting)

Par défaut, les comptes standards sont limités à un certain nombre de requêtes par seconde (affiché dans Paramètres > API > Limites). Au-delà, l'API retourne une erreur 429 Too Many Requests. Les comptes à fort volume peuvent demander une augmentation de cette limite.

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 avec l'ID de requête

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