Erreurs

Chaque erreur renvoie un corps JSON accompagné d'un code de statut HTTP.

Format des erreurs

Chaque réponse d'erreur utilise le même corps JSON, quel que soit le point de terminaison :

{
  "statusCode": 400,
  "error": "ValidationError",
  "message": "channel is required",
  "code": "optional_code",
  "field": "channel"
}

• statusCode — Le code de statut HTTP, répété dans le corps.
• error — Le nom de la classe d'erreur — utilisez-le pour distinguer les types d'erreur dans votre code.
• message — Une description lisible de ce qui s'est mal passé.
• code — Un code stable et exploitable par une machine, présent seulement quand l'erreur en définit un (par ex. plan_limit).
• field — Le champ de la requête en cause, présent seulement pour les erreurs de validation au niveau d'un champ.

Les erreurs serveur inattendues (500) ne divulguent jamais de détails internes — le message est toujours masqué :

{
  "statusCode": 500,
  "error": "InternalServerError",
  "message": "Something went wrong"
}

Codes de statut

Le champ error correspond à l'une des classes suivantes :

Limites de débit

L'API autorise 100 requêtes par minute au global, avec des limites plus strictes sur certains points de terminaison. Quand une requête est limitée, l'API renvoie 429.

Une réponse limitée en débit utilise la classe générique Error plutôt qu'un type d'erreur spécifique — son message indique combien de temps attendre avant de réessayer :

{
  "statusCode": 429,
  "error": "Error",
  "message": "Rate limit exceeded, retry in 1 minute"
}