Empezar
Errores
Los estados que la API devuelve de verdad y el sobre de error.
Sobre
Todo error vuelve en un objeto error con code, message y meta. El code es estable; el message es para personas y puede cambiar; meta trae el campo o el límite involucrado.
400 VALIDATION_FAILED
Códigos
| HTTP | code | Cuándo ocurre |
|---|---|---|
| 400 | VALIDATION_FAILED | Algún campo del cuerpo o de la consulta es inválido; meta dice cuál. |
| 400 | INVALID_RECIPIENT | El destinatario no es una dirección válida. |
| 401 | UNAUTHORIZED | Clave ausente, inválida o revocada. |
| 409 | DOMAIN_NOT_VERIFIED | El dominio del remitente aún no pasó la verificación de DNS. |
| 409 | EMAIL_NOT_CANCELLABLE | Solo se cancelan emails programados que aún no se enviaron. |
| 422 | INVALID_FROM_DOMAIN | El from usa un dominio que no pertenece a la organización. |
| 422 | SENDER_NOT_VERIFIED | El remitente suelto aún no confirmó el email. |
| 429 | PLAN_QUOTA_EXCEEDED | La cuota del plan se acabó en el ciclo; habilita excedente o cambia de plan. |
| 429 | RATE_LIMIT_EXCEEDED | Demasiadas solicitudes; espera el tiempo de retry-after. |
| 500 | TEMPLATE_RENDER_ERROR | La plantilla no se renderizó con las variables enviadas. |
Guarda el x-request-id de la respuesta: con él soporte encuentra la solicitud al instante.
En los SDKs
Los SDKs no lanzan excepción por error de la API: el error viene tipado en el resultado, con code, status y requestId.
Node.js
Go