API per Email Temporanea

API REST unificata per sviluppatori: crea indirizzi temp mail, ricevi email reali.

Mail.td è infrastruttura email per sviluppatori, con un'API REST unificata per creare indirizzi temporary email, ricevere email reali e consegnare nuovi messaggi in tempo reale tramite WebSocket o Webhook firmati. L'API è gratuita per iniziare — compatibile con qualsiasi client HTTP. Chiamala direttamente da test Selenium, Cypress, Playwright, Puppeteer, pipeline CI/CD o dal tuo backend.

Flusso di lavoro

Crea una casella, ricevi email reali tramite SMTP e leggi i messaggi tramite l'API REST. Le caselle scadono automaticamente dopo 7 giorni.

# 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 librerie client

Mail.td fornisce SDK ufficiali in tre linguaggi. Ogni client copre completamente l'API REST con risposte tipizzate e gestione degli errori — installa, autenticati con il tuo Pro API Token e inizia a usarlo.

Node.js / TypeScript

npm install mailtd

Client senza dipendenze con fetch nativo e definizioni di tipo TypeScript complete.

Python

pip install mailtd

Client basato su HTTP con tipi dataclass e supporto per context manager async.

Go

go get github.com/mailtd/mailtd-go

Solo stdlib, ciclo di vita delle richieste basato su context, struct completamente tipizzate.

Note importanti Le email del piano Pro vengono conservate per 7 giorni e poi eliminate automaticamente (consulta la pagina dei prezzi per la conservazione del piano gratuito). Mail.td è progettato per test email, automazione QA e uso temporaneo da parte di sviluppatori — non come casella di posta a lungo termine.