Erreurs API HTTP courantes et comment les résoudre
| Code HTTP | Cause probable | Solution |
|---|---|---|
| 400 | Paramètre manquant ou invalide (numéro mal formaté, champ requis absent) | Vérifiez le format de votre requête JSON et le format des numéros (+212...) |
| 401 | Clé API absente, invalide ou expirée | Vérifiez l'en-tête Authorization et régénérez la clé si besoin |
| 402 | Solde insuffisant sur le compte | Rechargez votre compte ou activez le rechargement automatique |
| 403 | Action non autorisée pour cette clé API (restriction de portée/IP) | Vérifiez les permissions associées à la clé utilisée |
| 404 | Ressource introuvable (ex. message_id inexistant) |
Vérifiez l'identifiant utilisé dans l'URL |
| 422 | Sender ID non validé ou incompatible avec le type de canal | Vérifiez le statut de validation de votre Sender ID |
| 429 | Limite de débit dépassée | Implémentez un système de retry avec délai progressif |
| 500 | Erreur interne côté plateforme | Contactez le support avec l'ID de requête (X-Request-ID) |
Chaque réponse d'erreur inclut un corps JSON avec un champ error.code et error.message détaillant précisément la cause.