| Code HTTP | Code d'erreur | Description | Solution |
|---|---|---|---|
| 🔐 Authentification | |||
| 401 | INVALID_API_KEY |
Clé API invalide ou révoquée | Vérifiez vos identifiants et générez une nouvelle clé dans votre espace client |
| 401 | INVALID_TOKEN |
Token d'authentification invalide | Reconnectez-vous pour obtenir un nouveau token |
| 403 | CLIENT_INACTIVE |
Compte client inactif | Contactez l'administrateur pour réactiver votre compte |
| 403 | USER_INACTIVE |
Utilisateur inactif | Contactez l'administrateur pour réactiver votre compte |
| 400 | VALIDATION_ERROR |
Erreur de validation des champs | Vérifiez les champs requis et leur format |
| 403 | NO_ACTIVE_API_KEY |
Aucune clé API active | Générez une clé API dans votre espace client |
| 📱 SMS | |||
| 400 | INVALID_PHONE |
Numéro de téléphone invalide | Utilisez le format international (+243XXXXXXXXX) |
| 400 | MESSAGE_TOO_LONG |
Message trop long (> 640 caractères) | Réduisez la longueur de votre message ou utilisez le multi-SMS |
| 402 | INSUFFICIENT_BALANCE |
Solde SMS insuffisant | Rechargez votre compte SMSGET via l'espace client |
| 403 | SENDER_NAME_NOT_APPROVED |
Sender Name non approuvé | Attendez l'approbation administrative ou utilisez un Sender Name déjà approuvé |
| 403 | SENDER_NAME_NOT_AUTHORIZED |
Sender Name non autorisé | Demandez l'ajout de ce Sender Name dans votre espace client |
| 400 | SENDER_NAME_INVALID_FORMAT |
Format du Sender Name invalide | Utilisez uniquement des lettres, chiffres et espaces (max 11 caractères) |
| ⏱️ Limites | |||
| 429 | DAILY_LIMIT_EXCEEDED |
Limite quotidienne dépassée | Attendez le lendemain ou contactez le support pour augmenter votre limite |
| 429 | MONTHLY_LIMIT_EXCEEDED |
Limite mensuelle dépassée | Attendez le mois prochain ou contactez le support pour augmenter votre limite |
| ⚠️ Erreurs système | |||
| 500 | SEND_ERROR |
Erreur lors de l'envoi du SMS | Réessayez plus tard ou contactez le support technique |
| 404 | NOT_FOUND |
Ressource non trouvée | Vérifiez l'ID de la ressource demandée |
| 404 | CLIENT_NOT_FOUND |
Client non trouvé | Vérifiez que votre compte client est actif |
{
"success": false,
"error": "Solde SMS insuffisant",
"code": "INSUFFICIENT_BALANCE",
"balance": 5,
"required": 10
}{
"success": false,
"error": "Sender Name non approuvé",
"code": "SENDER_NAME_NOT_APPROVED",
"sender_name": "MONSENDER",
"status": "pending"
}{
"success": false,
"error": "Clé API invalide ou révoquée",
"code": "INVALID_API_KEY"
}{
"success": false,
"error": "Validation échouée",
"code": "VALIDATION_ERROR",
"errors": {
"recipient": ["Le numéro de téléphone est requis"],
"message": ["Le message est requis"]
}
}