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.

Ver o guia rápido →

Referência da API

Os três endpoints com parâmetros, exemplos e códigos de status. O contrato, na íntegra.

Ver a referência →

Limites

Limite de taxa, tamanho de mensagem, retenção e tudo mais que tem um limite. Página curta, sem surpresas.

Ver os limites →

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_at está 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.io e 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 -all e nosso DMARC é p=reject, o que instrui todo servidor de recebimento do mundo a descartá-lo.