API de Email Temporário

API REST unificada para desenvolvedores: crie endereços de temp mail, receba emails reais.

Mail.td é infraestrutura de email para desenvolvedores, com uma API REST unificada para criar endereços de temporary email, receber emails reais e entregar novas mensagens em tempo real via WebSocket ou Webhooks assinados. A API é gratuita para começar — compatível com qualquer cliente HTTP. Chame-a diretamente de testes Selenium, Cypress, Playwright, Puppeteer, pipelines CI/CD ou seu próprio backend.

Fluxo de trabalho

Crie uma caixa de entrada, receba e-mails reais por SMTP e leia mensagens através da API REST. As caixas expiram automaticamente após 7 dias.

# 1. Create a mailbox
$ curl -X POST https://api.mail.td/api/accounts \
    -H "Authorization: Bearer td_xxx" \
    -d '{"address":"user@mail.td","password":"secret"}'
→ { "id": "a1b2c3d4-...", "address": "user@mail.td" }

# 2. List incoming messages
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages \
    -H "Authorization: Bearer td_xxx"
→ { "messages": [ { "id": "f5e6d7c8-...", "from": "...", "subject": "...", "created_at": "..." } ] }

# 3. Read a message
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages/f5e6d7c8-... \
    -H "Authorization: Bearer td_xxx"
→ { "from": "...", "subject": "...", "text_body": "...", "html_body": "...", "attachments": [...] }

SDK e bibliotecas cliente

Mail.td fornece SDKs oficiais em três linguagens. Cada cliente cobre totalmente a API REST com respostas tipadas e tratamento de erros — instale, autentique com seu Pro API Token e comece a usar.

Node.js / TypeScript

npm install mailtd

Cliente sem dependências usando fetch nativo, com definições de tipos TypeScript completas.

Python

pip install mailtd

Cliente baseado em HTTP com tipos dataclass e suporte a async context manager.

Go

go get github.com/mailtd/mailtd-go

Apenas stdlib, ciclo de vida de requisição baseado em context, structs totalmente tipados.

Notas importantes Os emails do plano Pro são retidos por 7 dias e depois excluídos automaticamente (consulte a página de preços para a retenção do plano gratuito). Mail.td foi projetado para testes de email, automação de QA e uso temporário por desenvolvedores — não como uma caixa de correio de longo prazo.