Gestion des erreurs

Format d’une erreur

Toutes les erreurs suivent le même format JSON :

{
  "statusCode": 400,
  "timestamp": "2026-01-20T10:30:00.000Z",
  "path": "/api/v1/send/sms",
  "method": "POST",
  "error": "Bad Request",
  "message": "Solde SMS insuffisant"
}

Le champ message est lisible et destiné à l’affichage ; le champ error peut porter un code d’action exploitable par votre intégration.

Codes HTTP

Code	Signification	À faire
`400`	Requête invalide	Vérifiez les paramètres et le message d’erreur
`401`	Clé API invalide ou manquante	Vérifiez l’en‑tête `Authorization`
`403`	Accès interdit	Compte suspendu ou ressource non autorisée
`404`	Ressource introuvable	Vérifiez l’URL et les identifiants
`409`	Conflit / action requise	Voir le champ `error` (ex. NINEA à soumettre)
`500`	Erreur serveur	Réessayez, puis contactez le support si persistant

Erreurs fréquentes

Solde SMS insuffisant

Votre solde ne couvre pas le coût de l’envoi (segments × pays × destinataires). Rechargez votre compte. Voir Tarification.

Signature non vérifiée ou invalide

Le Sender ID utilisé n’est pas approuvé. Voir Sender ID.

Envoi non autorisé (pays non disponible)

Le pays du destinataire n’est pas activé. Voir Numéros & pays.

Idempotence & réessais

En cas de timeout (30 s) ou d’erreur 500, un réessai est sûr pour la consultation de solde. Pour les envois, évitez de renvoyer aveuglément la même requête : vérifiez d’abord votre solde / vos logs pour ne pas facturer deux fois le même message.

Commencer

Concepts

Canaux

Format d’une erreur

Codes HTTP

Erreurs fréquentes

Idempotence & réessais

​Format d’une erreur

​Codes HTTP

​Erreurs fréquentes

​Idempotence & réessais

Format d’une erreur

Codes HTTP

Erreurs fréquentes

Idempotence & réessais