Erros da API do Email Center: email_account_required, all_recipients_suppressed e outros motivos

E-mail·· 16 visualizações· 3 min de leitura

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 My MozOut
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

VEJA TAMBÉM

Enviar um e-mail transaccional pela API: os campos do POST /v1/email/messages

Domínio remetente por verificar no Email Center: propagação, o campo found e os erros habituais

A lista de bloqueados do Email Center: porque um endereço deixa de receber e como o tirar

Créditos e limite diário do Email Center: o que paga um crédito e quando é devolvido

Testar o e-mail transaccional sem enviar: chaves Sandbox, modo de teste e devoluções simuladas

Tempos de espera, repetições e idempotência: como não cobrar duas vezes ao cliente

PRODUTO RECOMENDADO

Alojamento de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde $6.60/mês (plano de 3 anos, com cupão)

Ver planos
Esta resposta foi útil? A sua resposta ajuda-nos a melhorar este artigo.