Offene API
Erstelle temporäre Postfächer und lies E-Mails über eine einfache HTTP-API – ideal für automatisierte Tests und die Prüfung von Registrierungen. Alle Endpunkte liefern JSON.
Authentifizierung
Beim Erstellen eines Postfachs wird ein Token zurückgegeben. Sende es bei weiteren Anfragen mit:
Authorization: Bearer <token>
Ratenlimits
Ohne API-Schlüssel kann jede IP bis zu 10 Postfächer pro Minute erstellen. Für höhere Limits sende beim Erstellen einen API-Schlüssel mit:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpunkte
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /api/domains | Verfügbare Domains auflisten |
| POST | /api/mailbox | Postfach erstellen. Leerer Body für eine zufällige Adresse oder {"local":"abc","domain":"…"} für eine eigene |
| GET | /api/mailbox | Infos zum aktuellen Postfach |
| DELETE | /api/mailbox | Postfach und alle E-Mails löschen |
| GET | /api/messages | Posteingang auflisten (neueste 100) |
| GET | /api/messages/{id} | E-Mail abrufen (Inhalt und Anhänge) |
| DELETE | /api/messages/{id} | E-Mail löschen |
| GET | /api/messages/{id}/raw | Rohe .eml herunterladen |
| GET | /api/attachments/{id} | Anhang herunterladen |
| GET | /api/events | SSE-Ereignisstrom, sendet event: mail bei neuen E-Mails |
Beispiele
# 1. Postfach erstellen. Leerer Body für eine zufällige Adresse oder {"local":"abc","domain":"…"} für eine eigene
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. Posteingang auflisten (neueste 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. E-Mail abrufen (Inhalt und Anhänge)
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)
Fehler
Bei Fehlern wird ein Nicht-2xx-Status mit JSON-Body zurückgegeben:
{"error": "rate_limited", "message": "…"}