Erreurs

Ce que répond l'API quand elle ne peut pas faire ce que vous demandez, et que faire alors.

À quoi ressemble une erreur

Toutes les erreurs ont la même forme. Dans votre programme, utilisez code et non message, qui peut changer. Indiquez request_id si vous nous écrivez.

{
  "error": {
    "type": "invalid_request_error",
    "code": "missing_recipients",
    "message": "…",
    "param": "to",
    "doc_url": "https://www.mailingest.com/en/errors#missing_recipients",
    "request_id": "req_…"
  }
}

Que faire

  • 400, 401, 403, 404, 409 et 422La requête doit changer : la répéter donne la même réponse. message dit ce qui ne va pas et param dans quel champ.
  • 429Trop de requêtes ou une limite atteinte. Attendez le temps indiqué par Retry-After, s'il est présent. Une limite quotidienne ne se libère que le lendemain.
  • 500 et 503L'erreur vient de nous. Réessayez avec la même Idempotency-Key, pour éviter un double envoi.