DOCUMENTAÇÃO
API de e-mail
temporário.
Caixas válidas por 15 minutos. Somente recebimento. API pública, com limite de requisições.
1. Gerar uma caixa
Retorna id, email, user, domain, token, created_at, expires_at, ttl_seconds e ttl_minutes. Guarde o token: ele aparece apenas na criação. Sem domain, um domínio é escolhido aleatoriamente.
2. Consultar mensagens
Também aceita email no lugar de id. Para receber body_html, remova lite=1. O modo lite omite HTML e alguns metadados, mas body_text preserva as URLs HTTP/HTTPS dos links de confirmação. A validade não é renovada ao consultar.
3. Ler uma mensagem
Retorna a mensagem completa, com body_text e body_html. A interface oferece “Texto e URLs” e “Código HTML original”. O HTML é mostrado como código sem executar scripts ou rastreadores. body_html é conteúdo não confiável: nunca insira diretamente na página. Corpos continuam sujeitos ao limite de 200.000 caracteres.
4. Verificar serviço
Retorna os domínios configurados e a validade de 900 segundos. As quatro rotas também aceitam o prefixo /api/.
Exemplo cURL
Limites e erros
Criação: 10 caixas/minuto e 100/hora por IP. Consultas: 240/minuto por IP. SMTP: 1 MiB por mensagem, até 100 mensagens por caixa e 64 conexões simultâneas. Armazenamento de corpos: até 512 MiB no serviço.
Erros retornam status: "error" e message. HTTP 400: parâmetros; 403: token; 404: caixa/mensagem inexistente ou expirada; 409: endereço ocupado; 429: limite; 503: indisponibilidade ou capacidade.
Dados expirados ficam inacessíveis imediatamente e são excluídos do banco em até 30 segundos. Exclusão lógica não garante apagamento forense de discos. Anexos são descartados. Sem envio, relay ou garantia de entrega de terceiros.
O site e a API usam HTTPS. O SMTP desta primeira versão não oferece STARTTLS. Não use para dados sensíveis, recuperação de contas ou informações que precisam ser preservadas. CORS externo não está habilitado: integre pelo seu backend.