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.
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.