Erreurs

Si une requête retourne un code d'état 2xx, vous pouvez supposer que tout s'est bien déroulé.

Un code d'état 4xx signifie que la requête a échoué en raison des informations fournies. Un code d'état 5xx signifie qu'une erreur s'est produite de notre côté — notre équipe est alertée automatiquement lorsque cela survient.

Codes d'état

Code d'état	Raison
200 OK	Tout s'est bien déroulé.
201 Created	Une nouvelle ressource a été créée.
204 No Content	La ressource a été supprimée; aucun corps n'est retourné.
400 Bad Request	Les informations fournies sont invalides; la requête a échoué.
401 Unauthorized	L'authentification a échoué — vérifiez votre clé API secrète et son mode (Test ou Live).
404 Not Found	La ressource est introuvable.
500, 502, 503, 504	Une erreur s'est produite de notre côté.

Corps d'erreur

Lors d'une réponse 400 Bad Request, le corps de la réponse indique quels paramètres sont invalides :

{
  "message": "Your request is invalid.",
  "errors": {
    "<parameter>": [
      "Error message"
    ]
  }
}

• message — un résumé lisible de l'erreur.
• errors — un dictionnaire associant chaque paramètre invalide à la liste des problèmes détectés.
• reason — une raison plus courte et exploitable par la machine, incluse sur certaines erreurs.