✉ Email Temporaire

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éthodeCheminDescription
GET/api/domainsLister les domaines disponibles
POST/api/mailboxCréer une boîte. Corps vide pour une adresse aléatoire, ou {"local":"abc","domain":"…"} pour une adresse personnalisée
GET/api/mailboxInformations sur la boîte actuelle
DELETE/api/mailboxSupprimer la boîte et tous ses emails
GET/api/messagesLister 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}/rawTélécharger le .eml brut
GET/api/attachments/{id}Télécharger une pièce jointe
GET/api/eventsFlux 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": "…"}

← Retour à l'accueil