Errores

Qué responde la API cuando no puede hacer lo que pides, y qué hacer entonces.

Cómo es un error

Todos los errores tienen la misma forma. En tu programa usa code y no message, que puede cambiar. Incluye request_id si nos escribes.

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

Qué hacer

  • 400, 401, 403, 404, 409 y 422Hay que cambiar la petición: repetirla da la misma respuesta. message dice qué está mal y param en qué campo.
  • 429Demasiadas peticiones o un límite alcanzado. Espera lo que diga Retry-After, cuando venga. Un límite diario no se libera hasta el día siguiente.
  • 500 y 503El fallo es nuestro. Vuelve a intentarlo con la misma Idempotency-Key, para que no se envíe dos veces.