Skip to main content

Format

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request data",
    "details": []
  }
}

Authentification et quotas API

CodeHTTPDescription
UNAUTHORIZED401Clé API manquante, invalide ou révoquée. Vérifiez x-api-key.
FORBIDDEN403Ressource non accessible avec cette clé
SUBSCRIPTION_INACTIVE403Le compte n’a pas de souscription exploitable pour cette action
API_RATE_LIMIT_EXCEEDED429Plus de 10 requêtes/seconde sur la même clé
MONTHLY_API_REQUEST_QUOTA_EXCEEDED429Quota mensuel de requêtes API épuisé

Limites de plan

CodeHTTPDescription
MAX_INSTANCES_REACHED403Limite d’instances atteinte
API_KEYS_NOT_AVAILABLE_ON_PLAN403Clés API indisponibles sur le plan actuel
MAX_API_KEYS_REACHED403Limite de clés API atteinte
WEBHOOKS_NOT_AVAILABLE_ON_PLAN403Webhooks indisponibles sur le plan actuel
MAX_WEBHOOK_ENDPOINTS_REACHED403Limite d’endpoints webhook atteinte
CAMPAIGNS_NOT_AVAILABLE_ON_PLAN403Campagnes indisponibles sur le plan actuel
STATUSES_NOT_AVAILABLE_ON_PLAN403Statuts WhatsApp indisponibles sur le plan actuel
MAX_CONTACT_GROUPS_REACHED403Limite de groupes de contacts atteinte
FEATURE_NOT_AVAILABLE_ON_PLAN403Feature indisponible sur le plan courant

Messages, templates et validation

CodeHTTPDescription
VALIDATION_ERROR400Le body ne respecte pas le schéma attendu
BAD_REQUEST400Requête invalide
TEMPLATE_INVALID400Placeholder invalide ou template incohérent
TEMPLATE_VARIABLES_MISSING400Une ou plusieurs variables requises n’ont pas pu être résolues
TEMPLATE_CONTEXT_UNAVAILABLE400Le contexte demandé n’est pas disponible (instance ou contact)
INVALID_DESTINATION422Numéro destinataire invalide

Général

CodeHTTPDescription
NOT_FOUND404Ressource inexistante ou hors de votre compte
CONFLICT409Conflit d’unicité
INTERNAL_ERROR500Erreur serveur
PROVIDER_TIMEOUT502Timeout côté provider WhatsApp
PROVIDER_UNAVAILABLE502Provider temporairement indisponible
PROVIDER_ERROR502Erreur générique côté provider