Errori

Cosa risponde l'API quando non può fare ciò che chiedi, e cosa fare allora.

Com'è fatto un errore

Tutti gli errori hanno la stessa forma. Nel tuo programma usa code e non message, che può cambiare. Indica request_id se ci scrivi.

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

Cosa fare

  • 400, 401, 403, 404, 409 e 422La richiesta va cambiata: ripeterla dà la stessa risposta. message dice cosa non va e param in quale campo.
  • 429Troppe richieste o un limite raggiunto. Attendi quanto indicato da Retry-After, se presente. Un limite giornaliero si libera solo il giorno dopo.
  • 500 e 503L'errore è nostro. Riprova con la stessa Idempotency-Key, per non inviare due volte.