# Logs de requisições > Inspecione todas as requisições à API v2 e as transações SMTP feitas com as suas chaves de API, incluindo os corpos da requisição e da resposta, para depurar erros 4xx. **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.” | Origem | O que é registrado | | --- | --- | | **API** | Cada requisição a `https://api.emailit.com/v2/…` que o Emailit consegue associar ao seu workspace: método, caminho, código de status, duração, chave de API, endereço IP, user agent e os corpos da requisição e da resposta. | | **SMTP** | Cada comando `DATA`, com o resultado (`250 2.0.0 OK: queued as em_…` ou o erro), o remetente do envelope, os destinatários, os cabeçalhos e o tamanho da mensagem. Também as rejeições de `MAIL FROM` causadas por limites de envio (`452`) e as tentativas de `AUTH` com falha usando uma chave de API revogada (`535`). | 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](/pt/docs/api-reference/errors/) | | `401` | Chave de API ausente ou inválida. Chaves desconhecidas não são registradas. | [Autenticação](/pt/docs/api-reference/authentication/) | | `402` | Créditos insuficientes para o envio. | [Créditos](/pt/docs/billing/credits/) | | `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](/pt/docs/workspaces/production-access/) | | `409` | Um duplicado, ou uma requisição com o mesmo `Idempotency-Key` ainda em andamento. | [Idempotência](/pt/docs/api-reference/idempotency/) | | `413` | A mensagem tem mais de 40 MB. | [Anexos](/pt/docs/email-api/attachments/) | | `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](/pt/docs/api-reference/errors/) | | `429` | Limite de envio por segundo ou diário atingido. O corpo inclui `limit`, `current` e `retry_after`. | [Limites de requisições](/pt/docs/api-reference/rate-limits/) | 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](/pt/docs/smtp/troubleshooting/). 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](/pt/docs/logs/email-details/#deliveries-loads-and-clicks) 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 - [Erros da API](/pt/docs/api-reference/errors/) - [Solução de problemas do SMTP](/pt/docs/smtp/troubleshooting/) --- Fonte: https://emailit.com/pt/docs/logs/request-logs/