Aller plus loin
Codes d'erreur
Toutes les erreurs suivent le même format JSON et portent un code applicatif stable.
Format
{
"error": {
"code": "session_not_connected",
"message": "La session sess_2f9a n'est pas connectée.",
"status": 409
}
}Codes HTTP
| Paramètre | Type | Description |
|---|---|---|
| 200 / 201 | succès | Requête traitée. |
| 400 | erreur | Requête invalide : paramètre manquant ou mal formé. |
| 401 | erreur | Clé API absente, invalide ou révoquée. |
| 403 | erreur | Portée insuffisante ou ressource appartenant à un autre compte. |
| 404 | erreur | Ressource introuvable. |
| 409 | erreur | Conflit d'état, par exemple une session non connectée. |
| 429 | erreur | Limite de débit ou quota du forfait atteint. |
| 500 | erreur | Erreur interne : réessayez avec un délai croissant. |
200 / 201succèsRequête traitée.
400erreurRequête invalide : paramètre manquant ou mal formé.
401erreurClé API absente, invalide ou révoquée.
403erreurPortée insuffisante ou ressource appartenant à un autre compte.
404erreurRessource introuvable.
409erreurConflit d'état, par exemple une session non connectée.
429erreurLimite de débit ou quota du forfait atteint.
500erreurErreur interne : réessayez avec un délai croissant.
Codes applicatifs fréquents
| Paramètre | Type | Description |
|---|---|---|
| invalid_api_key | 401 | La clé n'existe pas ou a été révoquée. |
| insufficient_scope | 403 | La clé ne dispose pas de la portée requise. |
| session_not_connected | 409 | Le numéro WhatsApp n'est pas connecté. |
| invalid_phone | 400 | Numéro mal formé : format international sans « + » attendu. |
| media_too_large | 400 | Fichier trop volumineux, 16 Mo maximum. |
| quota_exceeded | 429 | Quota mensuel de messages atteint pour votre forfait. |
invalid_api_key401La clé n'existe pas ou a été révoquée.
insufficient_scope403La clé ne dispose pas de la portée requise.
session_not_connected409Le numéro WhatsApp n'est pas connecté.
invalid_phone400Numéro mal formé : format international sans « + » attendu.
media_too_large400Fichier trop volumineux, 16 Mo maximum.
quota_exceeded429Quota mensuel de messages atteint pour votre forfait.
Sur une erreur 500 ou 429, réessayez avec un délai croissant plutôt qu'en boucle immédiate.