A API REST do email temporário
Integre o email descartável, a caixa temporária e a deteção de OTP nas suas aplicações com poucas linhas. REST simples, JSON limpo, CORS aberto, sem autenticação.
Teste diretamente do navegador
Não precisa de Postman nem de um terminal. Escolha um endpoint, ajuste os parâmetros e execute. A resposta real da API aparece em direto.
Clique em «Executar» para enviar o pedido…
Clique em «Executar» para enviar o pedido…
Clique em «Executar» para enviar o pedido…
Sem parâmetros. Devolve a lista de domínios de email ativos.
Clique em «Executar» para enviar o pedido…
Endpoints
Todos os endpoints usam HTTPS, devolvem JSON UTF-8 e incluem os cabeçalhos X-RateLimit-* para acompanhar o seu consumo.
Copie e cole na sua stack
Fluxo completo: criar uma caixa → consultar os emails → extrair o código OTP. Na linguagem que preferir.
Limites de taxa
A API pública é gratuita e limitada por IP. As contas Premium multiplicam estes limites (×2–10) e têm uma quota por conta com a sua chave API.
- Criar uma caixa, 5/min · 50/h
- Ler mensagens, 10/min · 50/h
- Domínios, 10/min
- Quota por conta (não partilhada por IP)
Limites por oferta
| Oferta | Criar uma caixa | Ler mensagens | Domínios |
|---|---|---|---|
| Grátis (por IP) | 5/min · 50/h | 10/min · 50/h | 10/min |
| Mensal ×2 | 10/min · 100/h | 20/min · 100/h | 20/min |
| Anual ×2 | 10/min · 100/h | 20/min · 100/h | 20/min |
| Mensal API+ ×10 | 50/min · 500/h | 100/min · 500/h | 100/min |
Tornar-se Premium para multiplicar os seus limites.
O que os devs constroem com isto
Utilizações concretas da API do mail123, dos testes e2e à automação de marketing. Todas legítimas, todas sem registo.
Testes e2e automatizados
Playwright, Cypress, Selenium: gere um endereço em tempo real, preencha o formulário, leia o email de confirmação e extraia a ligação ou o código. Ciclo completo em 30 segundos.
Contornar a verificação de email
Registo em serviços duvidosos, contas descartáveis para experimentar uma demo ou acesso pontual a conteúdos que exigem email, sem poluir a caixa principal.
Bots e automação
Scrapers que têm de passar uma confirmação por email, fluxos n8n/Make/Zapier, scripts Selenium que automatizam o onboarding. A API integra-se com 3 linhas.
Ambientes de desenvolvimento
Ambientes de staging e preview: substitua o Mailtrap, o MailHog ou o SES por uma API pública. A equipa vê emails reais sem configurar SMTP.
Tutoriais e formações
Demos de webhooks, exercícios de OAuth, formação em segurança: um endereço público descartável permite praticar sem arriscar a caixa de correio real.
Ferramentas de privacidade
Extensões de navegador, gestores de palavras-passe, ferramentas antispam: integre a geração de alias numa única chamada HTTP.
Códigos HTTP e tratamento de erros
Todas as respostas incluem um campo success: bool e um campo opcional error: string. Os códigos HTTP seguem as convenções REST.
| Code | Significado | Ação |
|---|---|---|
| 200 | Success | A resposta inclui success: true |
| 400 | Bad Request | Verifique a sintaxe do endereço ou do parâmetro |
| 403 | Forbidden | Endereço reservado (admin, root, postmaster…) |
| 404 | Not Found | Email não encontrado ou expirado |
| 429 | Too Many Requests | Aguarde 1 minuto ou tente novamente após a reposição |
| 500 | Server Error | Erro do servidor: tente novamente e, se persistir, contacte o suporte |
Perguntas frequentes
Respostas às perguntas que os programadores mais nos colocam.
A API é mesmo gratuita?
Preciso de uma chave API?
A API suporta CORS?
Durante quanto tempo são guardados os emails?
A API deteta os códigos OTP automaticamente?
Que domínios de email estão disponíveis?
mail123.frmail456.frmail789.frmail1mail.commail123.clickmail123.com.brmail123.beermail123box.techmail123.promail123.sitemail123.onlinemail123.techmail123.website. Lista em direto com GET /api/v1/domains.A API suporta webhooks?
O que acontece se atingir o limite de pedidos?
Que utilizações são permitidas?
O serviço é fiável? Que disponibilidade tem?
Construa algo fantástico
Sem registo. Sem cartão. Sem configurar webhooks. Faça a sua primeira chamada à API em 10 segundos.