API ouverte
Créez des boîtes temporaires et lisez les emails via une API HTTP simple, idéale pour les tests automatisés et la vérification d'inscriptions. Tous les endpoints renvoient du JSON.
Authentification
La création d'une boîte renvoie un jeton. Envoyez-le dans les requêtes suivantes :
Authorization: Bearer <token>
Limites
Sans clé API, chaque IP peut créer jusqu'à 10 boîtes par minute. Pour des limites plus élevées, envoyez une clé API lors de la création :
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpoints
| Méthode | Chemin | Description |
|---|---|---|
| GET | /api/domains | Lister les domaines disponibles |
| POST | /api/mailbox | Créer une boîte. Corps vide pour une adresse aléatoire, ou {"local":"abc","domain":"…"} pour une adresse personnalisée |
| GET | /api/mailbox | Informations sur la boîte actuelle |
| DELETE | /api/mailbox | Supprimer la boîte et tous ses emails |
| GET | /api/messages | Lister la boîte de réception (100 derniers) |
| GET | /api/messages/{id} | Obtenir un email (corps et pièces jointes) |
| DELETE | /api/messages/{id} | Supprimer un email |
| GET | /api/messages/{id}/raw | Télécharger le .eml brut |
| GET | /api/attachments/{id} | Télécharger une pièce jointe |
| GET | /api/events | Flux d'événements SSE, envoie event: mail à chaque nouvel email |
Exemples
# 1. Créer une boîte. Corps vide pour une adresse aléatoire, ou {"local":"abc","domain":"…"} pour une adresse personnalisée
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. Lister la boîte de réception (100 derniers)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Obtenir un email (corps et pièces jointes)
curl -s https://www.temp-mail.cc/api/messages/123 \
-H 'Authorization: Bearer <token>'
# Python
import requests, time
base = "https://www.temp-mail.cc"
mb = requests.post(f"{base}/api/mailbox", json={}).json()
headers = {"Authorization": f"Bearer {mb['token']}"}
print(mb["address"])
while True:
msgs = requests.get(f"{base}/api/messages", headers=headers).json()["messages"]
if msgs:
print(requests.get(f"{base}/api/messages/{msgs[0]['id']}", headers=headers).json()["text"])
break
time.sleep(3)
Erreurs
En cas d'erreur, un statut non-2xx est renvoyé avec un corps JSON :
{"error": "rate_limited", "message": "…"}