Documentação
Três endpoints e nenhuma conta. Não há muito o que aprender, então não há muito o que ler.
Comece aqui
Início rápido
Uma caixa de entrada funcional e uma mensagem lida de volta, em quatro comandos. Comece aqui se você nunca chamou a API.
Referência da API
Os três endpoints com parâmetros, exemplos e códigos de status. O contrato, na íntegra.
Limites
Limite de taxa, tamanho de mensagem, retenção e tudo mais que tem um limite. Página curta, sem surpresas.
Guias
Guias mais longos, com os modos de falha: o que fazer, não o que um parâmetro significa.
Quanto tempo dura uma caixa descartável
A quem se aplica a janela de 5 dias e a quem não se aplica, quando o relógio realmente começa, tudo o que vai junto com uma mensagem, como ler o prazo direto na API, e o hábito que faz com que nada disso importe.
O que é email temporário
A definição, a mecânica (um registro MX e uma caixa que existe assim que chega a primeira mensagem), email temporário contra descartável, burner e alias, para que serve, os quatro casos em que é a ferramenta errada e quanto dura um endereço.
Testes de email no Playwright
Uma fixture que abre uma caixa nova por teste, uma espera com prazo de relógio em vez de contagem de tentativas, extratores ancorados no seu próprio template, três fluxos completos (código, link mágico, redefinição de senha) e como sobrevive na CI sem segredo.
As quatro coisas que vale a pena saber
- Uma caixa de entrada não é criada
- Não existe uma chamada de "criar endereço". Um endereço existe no momento em que um e-mail chega até ele, e deixa de existir quando a última mensagem expira.
- O endereço é a credencial
- Em um domínio público, quem souber o endereço pode lê-lo — pela API exatamente como pelo site. Use seu próprio domínio quando isso não for aceitável.
- Tudo expira
- As mensagens são excluídas 5 dias após chegarem.
expires_atestá em toda mensagem, então você nunca precisa calculá-lo. - Somente recebimento
- Nenhum endpoint envia e-mail. Isso é proposital: é o que impede que um serviço gratuito e sem autenticação vire um retransmissor de spam.
Quando algo está errado
Se uma chamada se comportar de forma diferente desta documentação, a documentação é o bug — avise-nos e será corrigido.
- O email nunca chega
- Primeiro verifique o registro MX:
smtp.grabmail.ioe nada mais. Um MX residual de um provedor anterior desvia parte do seu tráfego silenciosamente. - A API responde 404
- Ou o domínio não está apontado para cá, ou a mensagem passou da janela de retenção. Os dois casos são distinguidos pelo slug
error. - Email alega vir de nós
- É falsificado. Nada aqui pode enviar email — nosso SPF é
v=spf1 -alle nosso DMARC ép=reject, o que instrui todo servidor de recebimento do mundo a descartá-lo.