API d'Email Temporaire

API REST unifiée pour développeurs : créez des adresses temp mail, recevez de vrais emails.

Mail.td est une infrastructure email pour développeurs, avec une API REST unifiée pour créer des adresses temporary email, recevoir de vrais emails et livrer les nouveaux messages en temps réel via WebSocket ou Webhooks signés. L'API est gratuite pour démarrer — compatible avec tout client HTTP. Appelez-la directement depuis vos tests Selenium, Cypress, Playwright, Puppeteer, pipelines CI/CD ou votre propre backend.

Flux de travail

Créez une boîte mail, recevez de vrais emails via SMTP et lisez les messages via l'API REST. Les boîtes expirent automatiquement après 7 jours.

# 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 et bibliothèques client

Mail.td fournit des SDK officiels en trois langages. Chaque client couvre entièrement l'API REST avec des réponses typées et la gestion des erreurs — installez, authentifiez-vous avec votre Pro API Token et commencez à utiliser.

Node.js / TypeScript

npm install mailtd

Client sans dépendances utilisant fetch natif, avec définitions de types TypeScript complètes.

Python

pip install mailtd

Client basé sur HTTP avec types dataclass et support du context manager async.

Go

go get github.com/mailtd/mailtd-go

Uniquement stdlib, cycle de vie des requêtes basé sur context, structs entièrement typées.

Notes importantes Les emails du plan Pro sont conservés 7 jours puis supprimés automatiquement (consultez la page Tarifs pour la rétention du plan gratuit). Mail.td est conçu pour les tests d'email, l'automatisation QA et l'usage temporaire développeur — pas comme une boîte mail à long terme.