Guide

Erreurs

Chaque erreur a un statut HTTP, un code stable et un message que vous pouvez afficher.

L'objet d'erreur

Les erreurs utilisent les statuts HTTP habituels. Le corps a toujours la même forme. code est stable et fiable pour votre logique; message est écrit pour les gens.

json

{
  "error": {
    "code": "invalid_request",
    "message": "Some fields are missing or invalid.",
    "details": [ { "path": "recipients.0.email", "message": "Invalid email address" } ]
  }
}

Envoyez Accept-Language: fr pour recevoir les messages en français. Les codes ne changent jamais avec la langue.

Réessayer

Les erreurs 4xx veulent dire que la requête doit changer. Refaire la même requête donne la même réponse, sauf pour 409 request_in_progress et 429.
429 veut dire de ralentir : attendez le délai de l'en-tête Retry-After.
Vous pouvez réessayer après une erreur 500 ou 503, en espaçant les essais. Réutilisez la même Idempotency-Key pour que rien ne se produise deux fois.

La liste complète est à la page Codes d'erreur.