Go
Errores y reintentos
Un único tipo de error para cada fallo, un centinela para cada clase y reintentos que no pueden enviar dos veces.
Gestionar un error
_, err := client.Emails.Send(ctx, openemail.Body{ "from": "[email protected]", "to": "[email protected]", "subject": "Your September invoice", "text": "Invoice attached.",}) var failure *openemail.Error switch {case err == nil: fmt.Println("sent")case errors.Is(err, openemail.ErrValidation): errors.As(err, &failure) fmt.Println(failure.Code, failure.Param, failure.Message)case errors.Is(err, openemail.ErrRateLimited): errors.As(err, &failure) fmt.Println("try again in", failure.RetryAfter)case errors.Is(err, openemail.ErrTimeout): fmt.Println("no answer in time")default: return err}Cada fallo es un *openemail.Error. errors.Is dice de qué clase es, y errors.As entrega el propio error, con lo que la API dijo sobre él.
| Campo | Qué contiene |
|---|---|
| Status | El estado HTTP, o 0 cuando no llegó ninguna respuesta. |
| Type, Code | El tipo de error y el código de la API, como validation_error e invalid_parameter. |
| Param | El campo culpable, cuando lo hay. |
| RequestID | El id que debes citar cuando escribas a soporte. |
| DocURL | La página de la documentación que explica el código. |
| RetryAfter | Cuánto te pidió la API que esperaras. |
| Fields | Los campos que rechazó un formulario de suscripción, cada uno con una Key y un Error. |
| Body | El cuerpo de la respuesta, decodificado. |
Las clases de fallo
| Centinela | Cuándo coincide |
|---|---|
| ErrAuthentication | La clave o el token fue rechazado, con un 401. |
| ErrPermission | La credencial no puede hacer esto, con un 403. |
| ErrScopeMissing | A la credencial le falta el ámbito que la llamada necesita. |
| ErrStepUpRequired | Un token de acceso tiene que verificar antes un código. |
| ErrNotFound | Nada tiene ese id, con un 404. |
| ErrConflict | El cambio entra en conflicto con el estado actual, con un 409. |
| ErrValidation | Se rechazó un campo, con un 422. |
| ErrRateLimited | Demasiadas peticiones, o una cuota está agotada, con un 429. |
| ErrInvalidRequest | Cualquier otro rechazo de la petición. |
| ErrServer | La API falló, con un estado de 500 o superior. |
| ErrRetryable | El estado es uno de los que el cliente reintenta. |
| ErrNetwork | No llegó ninguna respuesta. |
| ErrTimeout | No llegó ninguna respuesta antes de que venciera el tiempo de espera. |
| ErrInvalidArgument | La propia llamada era incorrecta, y no se envió nada. |
| ErrWebhookSignature | Una entrega de webhook no superó su comprobación. |
Un contexto cancelado sigue coincidiendo con context.Canceled, y un plazo vencido coincide con context.DeadlineExceeded.
Lo que se reintenta
- Las lecturas, los envíos y toda escritura que es seguro repetir se reintentan, hasta
WithMaxRetriesveces. Cualquier otra escritura se envía una sola vez. - Los estados 408, 500, 502, 503 y 504 se reintentan con una espera que empieza en medio segundo y se duplica hasta ocho segundos.
- Un 429 se reintenta solo cuando lleva un
Retry-Afterde un minuto o menos, y el cliente espera ese tiempo. - Una conexión que falla o que agota el tiempo de espera se reintenta del mismo modo.
Un envío que se reintenta lleva siempre la misma clave de idempotencia, así que la API reproduce el primer mensaje en vez de enviar un segundo.