Testando com o Sandbox de E-mail do Mailtrap

Visão Geral

O Sandbox de E-mail captura e-mails em sandboxes (caixas de entrada de teste) — um ambiente de teste onde as mensagens não são entregues a destinatários reais. Você pode enviar para sandboxes usando nossos SDKs, API HTTP ou SMTP, dependendo das suas necessidades.

Antes de gerar o código do SDK: leia o README do repositório do SDK relevante (veja mailtrap-sending-emails) para opções atuais do modo sandbox, ID da caixa de entrada e flags do construtor. Não confie na memória.

Habilidades relacionadas: mailtrap-sending-emails (hosts e streams de envio ao vivo).

Quando usar

• Você quer nenhuma entrega real: em desenvolvimento, staging, CI ou demonstrações onde o e-mail deve permanecer em uma caixa de entrada de teste.
• Você precisa inspecionar o que foi enviado: corpos, cabeçalhos, anexos ou verificações básicas (por exemplo, relatório de spam) via API de Sandbox / Teste ou a Interface do Usuário.
• Você está automatizando testes contra e-mails capturados.
• Você apenas alterará as configurações SMTP para que um aplicativo existente envie para um sandbox — não há necessidade de um tutorial framework por framework nesta habilidade.

Quando não usar

• Envios ao vivo para destinatários reais (mailtrap-sending-emails).
• Para guias completos de configuração de framework ou referências detalhadas da API, direcione os usuários para a aba Integração do Mailtrap para detalhes de SMTP/API e para a documentação da API para especificidades — não cubra todos os frameworks ou campos da API aqui.

Referência Rápida

Base da API

Tokens e account_id

O Sandbox usa um token separado ($MAILTRAP_SANDBOX_API_TOKEN, escopo de Teste/Sandbox) — nunca reutilize o $MAILTRAP_API_TOKEN ao vivo. O account_id nos exemplos de endpoints abaixo é resolvido em tempo de execução via GET https://mailtrap.io/api/accounts. Armazene tokens em variáveis de ambiente ou em um gerenciador de segredos.

Quando usar API vs SMTP

Use SMTP ao testar aplicativos que já enviam e-mails via SMTP (apenas atualize o host, porta e credenciais). Use a API HTTP ao construir novas integrações ou quando seu aplicativo pode fazer requisições HTTP; é melhor para testes programáticos e automação.

Configurações SMTP (sandbox)

Nunca use credenciais ou endpoints de sandbox em produção. As mensagens serão apenas capturadas no sandbox, não entregues.

Parâmetros chave

• ID da Caixa de Entrada: Cada sandbox (caixa de entrada de teste) tem um ID de caixa de entrada exclusivo, visível na URL da interface do usuário e necessário para operações de envio ou API REST.
• Escopo do Token: Use um token com permissões para o projeto relevante e a caixa de entrada de teste.

Casos de uso típicos

• Capturar todos os e-mails de saída em desenvolvimento, teste ou staging (sem destinatários reais).
• Visualizar, validar e afirmar cabeçalhos, corpos, HTML, anexos ou pontuação de spam de mensagens.
• Executar verificações de integração ou CI que leem da API do Sandbox de E-mail.
• Testar templates do Mailtrap apontando a API ou SDK/SMTP para sandbox.api.mailtrap.io / sandbox.smtp.mailtrap.io com um ID de caixa de entrada válido.

Exemplos de caminhos da API

Use a documentação da API para detalhes, mas endpoints típicos incluem:

…