Logs de requisições

Email API›Logs registra o tráfego da API e do SMTP que chega ao Emailit com as suas chaves de API. Quando um envio falha antes mesmo de o e-mail ser criado, por exemplo por causa de um erro de validação ou de um limite de requisições, é no log de requisições que você vê o que o seu código enviou e exatamente o que o Emailit respondeu.

O que é registrado

O cabeçalho da página resume: “Successful and failed API v2 and SMTP requests authenticated with an API key.”

Não são registrados:

• Requisições sem chave de API ou com uma chave desconhecida, porque não podem ser associadas a um workspace. Se você receber 401 Invalid API key e não vir nada aqui, confira qual chave o seu código usa.
• A atividade no painel e os comandos SMTP AUTH bem-sucedidos.

Os valores sensíveis são ocultados antes do armazenamento. Campos com nomes como password, secret, token, authorization ou api_key, e valores que parecem chaves de API (secret_…) ou tokens, são substituídos por [redacted]. Strings longas são cortadas em 16.384 caracteres e arrays em 50 itens, então anexos grandes não aparecem por inteiro.

Encontrar uma requisição

• Período: escolha Last 1 hour, Last 6 hours, Last 24 hours (padrão), Last 72 hours, Last 7 days ou Last 30 days, ou escolha um intervalo de datas personalizado. Você também pode arrastar sobre o gráfico para ampliar um período.
• Gráfico: requisições bem-sucedidas e com falha ao longo do tempo, para você identificar quando os erros começaram.
• Pesquisa: busca no caminho, na mensagem, no método ou no status.
• Filtros: Source (API ou SMTP), Outcome (Success ou Error), Method, Path, Message, Status code, Duration, Created e API key.

A tabela mostra Timestamp, Level (Success para códigos de status abaixo de 400, Error para os demais), Source, Method, Message (por exemplo POST /v2/emails → 422), Status e Duration.

Ler uma requisição

Selecione uma linha para abri-la. A página mostra:

• Created, Level, Source e Status.
• Request body: o JSON que o seu código enviou ou, para SMTP, o comando, o envelope e o resumo da mensagem.
• Response body: o que o Emailit retornou, incluindo os detalhes do erro.
• Details: o ID do log, o caminho, a duração, o ID da chave de API (credential_id), o endereço IP, o user agent e o ID da requisição.

Depurar erros 4xx

1. Filtre os erros. Defina Outcome como Error, ou Status code como o código que você recebeu, e escolha um período que cubra a falha.

2. Abra a requisição e leia o corpo da resposta. Os corpos de erro do Emailit dizem o que deu errado. Os erros de validação listam cada problema em validation_errors ou details.

3. Compare com o corpo da requisição. Confira os campos que o Emailit recebeu. As surpresas típicas são um domínio ausente em from, to enviado como objeto ou um scheduled_at em um formato inesperado.

4. Escolha a correção de acordo com o código de status.

   Status	Causa comum	Onde saber mais
   400	JSON malformado ou um erro de validação.	Erros
   401	Chave de API ausente ou inválida. Chaves desconhecidas não são registradas.	Autenticação
   402	Créditos insuficientes para o envio.	Créditos
   403	O workspace não está verificado e um destinatário não é membro (unverified_workspace_recipient), a chave está restrita a outro domínio, o recurso exige um plano superior (plan_required) ou o workspace está suspenso.	Acesso de produção
   409	Um duplicado, ou uma requisição com o mesmo Idempotency-Key ainda em andamento.	Idempotência
   413	A mensagem tem mais de 40 MB.	Anexos
   422	A requisição é válida, mas não pode ser executada, por exemplo tentar de novo um e-mail que não permite nova tentativa.	Erros
   429	Limite de envio por segundo ou diário atingido. O corpo inclui limit, current e retry_after.	Limites de requisições

   No SMTP, os mesmos problemas aparecem como códigos de resposta SMTP, por exemplo 530 quando o domínio do From não está verificado ou 452 para limites de envio. Consulte Solução de problemas do SMTP.

5. Corrija e envie de novo. Uma requisição que falhou com 4xx não criou nenhum e-mail, então é seguro enviá-la de novo depois de corrigida.

Se a requisição foi bem-sucedida aqui, mas o e-mail não chegou, o problema aconteceu depois. Encontre o e-mail em Email API›Emails e leia as tentativas de entrega dele.

Retenção

Os logs de requisições seguem o período de retenção de Logs:

	Pay as you go	Pro	Business	Custom
Retenção dos logs de requisições	7 dias	30 dias	30 dias	Flexível

Os logs de requisições só estão disponíveis no painel; não há endpoint de API para eles.

Veja também