Começar
Erros
Os status que a API devolve de verdade e o envelope de erro.
Envelope
Todo erro volta num objeto error com code, message e meta. O code é estável; a message é para pessoas e pode mudar; meta traz o campo ou o limite envolvido.
400 VALIDATION_FAILED
Códigos
| HTTP | code | Quando acontece |
|---|---|---|
| 400 | VALIDATION_FAILED | Algum campo do corpo ou da consulta é inválido; meta diz qual. |
| 400 | INVALID_RECIPIENT | O destinatário não é um endereço válido. |
| 401 | UNAUTHORIZED | Chave ausente, inválida ou revogada. |
| 409 | DOMAIN_NOT_VERIFIED | O domínio do remetente ainda não passou na verificação de DNS. |
| 409 | EMAIL_NOT_CANCELLABLE | Só emails agendados e ainda não enviados podem ser cancelados. |
| 422 | INVALID_FROM_DOMAIN | O from usa um domínio que não pertence à organização. |
| 422 | SENDER_NOT_VERIFIED | O remetente avulso ainda não confirmou o email. |
| 429 | PLAN_QUOTA_EXCEEDED | A cota do plano acabou no ciclo; libere excedente ou mude de plano. |
| 429 | RATE_LIMIT_EXCEEDED | Muitas requisições; espere o tempo de retry-after. |
| 500 | TEMPLATE_RENDER_ERROR | O modelo não renderizou com as variáveis enviadas. |
Guarde o x-request-id da resposta: com ele o suporte acha a requisição na hora.
Nos SDKs
Os SDKs não lançam exceção por erro da API: o erro vem tipado no resultado, com code, status e requestId.
Node.js
Go