Erros

Como é um erro

Todos os erros têm a mesma forma. No teu programa usa code e não message, que pode mudar. Inclui request_id se nos escreveres.

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

O que fazer

• 400, 401, 403, 404, 409 e 422O pedido tem de mudar: repeti-lo dá a mesma resposta. message diz o que está mal e param em que campo.
• 429Demasiados pedidos ou um limite atingido. Espera o que indicar Retry-After, quando vier. Um limite diário só se liberta no dia seguinte.
• 500 e 503A falha é nossa. Tenta de novo com a mesma Idempotency-Key, para não enviar duas vezes.