Saltar al contenido principal
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
{  "error": {    "code": "VALIDATION_FAILED",    "message": "O campo to precisa de pelo menos 1 destinatário",    "meta": { "field": "to" }  }}

Códigos

HTTPcodeCuándo ocurre
400VALIDATION_FAILEDAlgún campo del cuerpo o de la consulta es inválido; meta dice cuál.
400INVALID_RECIPIENTEl destinatario no es una dirección válida.
401UNAUTHORIZEDClave ausente, inválida o revocada.
409DOMAIN_NOT_VERIFIEDEl dominio del remitente aún no pasó la verificación de DNS.
409EMAIL_NOT_CANCELLABLESolo se cancelan emails programados que aún no se enviaron.
422INVALID_FROM_DOMAINEl from usa un dominio que no pertenece a la organización.
422SENDER_NOT_VERIFIEDEl remitente suelto aún no confirmó el email.
429PLAN_QUOTA_EXCEEDEDLa cuota del plan se acabó en el ciclo; habilita excedente o cambia de plan.
429RATE_LIMIT_EXCEEDEDDemasiadas solicitudes; espera el tiempo de retry-after.
500TEMPLATE_RENDER_ERRORLa 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
const { data, error } = await coffeemail.emails.send(payload); if (error instanceof ValidationError) return showFieldErrors(error.details);if (error instanceof RateLimitError) return retryLater(error);if (error) throw error; console.log(data.id, data.status);
Go
_, err := client.Domains.Get(ctx, id)if errors.Is(err, coffeemail.ErrNotFound) {	return nil} var apiErr *coffeemail.Errorif errors.As(err, &apiErr) {	log.Printf("status=%d code=%s requestId=%s", apiErr.Status, apiErr.Code, apiErr.RequestID)}