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.