Guia de introdução à API do DustMail
A API do DustMail permite automatizar a criação de caixas de entrada de e-mail temporárias e o recebimento de mensagens. Isso é perfeito para testes automatizados, pipelines de CI/CD e desenvolvimento de aplicativos seguros. Este guia aborda todos os endpoints principais com exemplos práticos em cURL, Node.js e Python.
Autenticação
Todas as requisições de API exigem uma chave de API. Você pode gerar essa chave no seuPainel de controle, depois passe-a através do cabeçalho Authorization:
Authorization: Bearer dm_live_your_api_key
Criar uma caixa de entrada
Envie uma requisição POST para criar um novo endereço de e-mail temporário:
POST https://dustmail.net/api/v1/inbox
Exemplo com cURL
curl -X POST https://dustmail.net/api/v1/inbox \ -H "Authorization: Bearer dm_live_xxx" \ -H "Content-Type: application/json" \ -d '{"duration": 30}'
Consultar novos e-mails (Polling)
Após criar a caixa de entrada, faça chamadas à API para verificar a chegada de novas mensagens:
GET https://dustmail.net/api/v1/inbox/YOUR_INBOX_ID
Limites de chamadas (Rate Limits)
Contas gratuitas recebem até 100 chamadas de API por dia. Contas Premium recebem chamadas de API ilimitadas – atualize na página de Preços.
Casos de uso
- Testes E2E - Crie caixas de entrada em suítes de testes para verificar fluxos de cadastro
- Pipelines de CI/CD - Automatize a verificação de e-mails em fluxos de deploy
- Apps de Privacidade - Integre e-mail descartável diretamente no seu produto