Primeiros Passos: Obtendo Sua Chave de API
Para começar a usar a API do EvilMail, você precisa gerar uma chave de API. Acesse o painel do EvilMail em Configurações > API > Gerar Nova Chave. Guarde sua chave em local seguro — ela não será exibida novamente.
Todas as requisições à API devem incluir o header de autenticação:
Authorization: Bearer YOUR_API_KEYCriando E-mails Temporários
O endpoint principal para criar e-mails descartáveis é:
curl -X POST https://evilmail.com/api/temp-email
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"domain": "evilmail.com", "prefix": "meu-teste"}'Resposta:
{
"email": "[email protected]",
"created_at": "2026-03-12T10:00:00Z",
"expires_at": "2026-03-13T10:00:00Z"
}O campo prefix é opcional. Se omitido, um endereço aleatório será gerado.
Consultando a Caixa de Entrada
Para verificar os e-mails recebidos em um endereço:
curl -X GET https://evilmail.com/api/inbox/[email protected]
-H "Authorization: Bearer YOUR_API_KEY"Resposta:
{
"email": "[email protected]",
"messages": [
{
"id": "msg_abc123",
"from": "[email protected]",
"subject": "Confirme seu cadastro",
"body": "Clique no link para verificar...",
"received_at": "2026-03-12T10:05:00Z"
}
]
}Gerenciando Domínios
Se você possui um domínio personalizado configurado, pode listar os domínios disponíveis:
curl -X GET https://evilmail.com/api/domains
-H "Authorization: Bearer YOUR_API_KEY"Resposta:
{
"domains": [
{"domain": "evilmail.com", "type": "shared"},
{"domain": "meudominio.com.br", "type": "custom", "verified": true}
]
}Com domínios personalizados, você pode criar e-mails temporários usando seu próprio domínio:
curl -X POST https://evilmail.com/api/temp-email
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"domain": "meudominio.com.br", "prefix": "suporte"}'Casos de Uso
Testes Automatizados
Integre a API no seu pipeline de CI/CD para testar fluxos de cadastro, recuperação de senha e notificações por e-mail sem depender de caixas de entrada reais.
Isolamento de Serviços
Crie um e-mail descartável único para cada serviço em que você se cadastrar. Se um deles for comprometido, os demais permanecem seguros.
Prototipagem Rápida
Durante o desenvolvimento, use a API para gerar endereços de teste rapidamente, sem necessidade de configurar servidores de e-mail.
Monitoramento de Serviços
Crie endereços que recebem alertas e notificações, monitorando a entrega programaticamente via API.
Limites e Boas Práticas
- Rate limiting: 100 requisições por minuto por chave de API
- Expiração: E-mails temporários expiram em 24 horas por padrão (configurável)
- Tamanho: Mensagens de até 25 MB são suportadas
- Armazene sua chave de API de forma segura — nunca a exponha em código do lado do cliente
- Implemente tratamento de erros para respostas 429 (rate limit) e 5xx (erro do servidor)