Português
English
A resposta curta: o código HTTP diz o tipo de problema e o campo details.reason diz o motivo exacto. No Email Center, os mais comuns são email_account_required (o serviço não está activo), domain_not_verified (o remetente não é de um domínio verificado) e all_recipients_suppressed (todos os destinatários estão bloqueados). Use sempre o code e o reason no seu programa, nunca o texto da mensagem.
403: a conta ou a chave
| Código e motivo | O que quer dizer | O que fazer |
| forbidden + email_account_required | A conta não tem o Email Center activo | Active-o na página E-mail transaccional do Meu Interweb |
| insufficient_scope | A chave não tem a permissão | Crie uma chave com email_center:write (ou email_center:read para consultar) |
422: os dados do e-mail
| Motivo | O que corrigir |
| domain_not_verified | O from tem de ser de um domínio verificado. Veja domínio por verificar |
| from_required / from_invalid | Falta o remetente ou o endereço não é válido |
| invalid_recipient / too_many_recipients | Endereços inválidos ou mais de 50 destinatários |
| all_recipients_suppressed | Todos estão na lista de bloqueados: nada sai nem se cobra. Veja a lista de bloqueados |
| subject_required / subject_too_long | Falta o assunto ou passa de 998 caracteres |
| content_required | Envie html, text ou um template_id |
| template_not_found / invalid_variables | O modelo não existe nesta conta, ou variables não é um objecto |
| attachment_blocked / attachments_too_large | Ficheiro proibido ou anexos grandes demais. Veja anexos |
| invalid_send_at / send_at_in_past / send_at_too_far | A data de agendamento. Veja agendar |
| insufficient_credits / daily_limit_reached | Sem créditos ou no limite diário. Veja créditos e limite diário |
409: o estado não deixa
| Motivo | O que quer dizer |
| domain_exists | O domínio já está na sua lista |
| domain_in_use | O domínio já está verificado noutra conta. Fale connosco |
| domain_limit / template_limit | Chegou ao máximo de domínios ou de modelos |
| template_name_exists | Já há um modelo com esse nome |
| not_cancellable | Só se cancelam agendados que ainda não saíram |
| idempotency_conflict | A mesma Idempotency-Key com outro corpo, ou com o primeiro pedido ainda em curso |
Repetir ou corrigir
Vale a pena repetir, com espera, só 429, 500, 502 e 503. Os outros repetem-se iguais até corrigir o pedido. Repita sempre com a mesma Idempotency-Key, para o e-mail não sair duas vezes.
| Guarde o correlation_id de cada erro. Se precisar de ajuda, mande-o ao suporte com a hora do pedido. Nunca mande a chave: o suporte não precisa dela. |
|
Um erro que não consegue resolver? Abra um pedido de suporte com o correlation_id. Abrir um pedido de suporte |
PRODUTO RECOMENDADO Hospedagem de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 321,75 MT/mês (plano de 3 anos, com cupão) Ver planos |
