Open API
Maak tijdelijke inboxen aan en lees e-mails met een eenvoudige HTTP-API, ideaal voor geautomatiseerde tests en het controleren van aanmeldingen. Alle endpoints geven JSON terug.
Authenticatie
Bij het aanmaken van een inbox krijg je een token terug. Stuur dit mee bij volgende verzoeken:
Authorization: Bearer <token>
Limieten
Zonder API-sleutel kan elk IP-adres tot 10 inboxen per minuut aanmaken. Voor hogere limieten stuur je een API-sleutel mee bij het aanmaken:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpoints
| Methode | Pad | Beschrijving |
|---|---|---|
| GET | /api/domains | Beschikbare domeinen tonen |
| POST | /api/mailbox | Inbox aanmaken. Lege body voor een willekeurig adres, of {"local":"abc","domain":"…"} voor een eigen adres |
| GET | /api/mailbox | Info over de huidige inbox |
| DELETE | /api/mailbox | Inbox en alle e-mails verwijderen |
| GET | /api/messages | Inbox tonen (laatste 100) |
| GET | /api/messages/{id} | E-mail ophalen (inhoud en bijlagen) |
| DELETE | /api/messages/{id} | E-mail verwijderen |
| GET | /api/messages/{id}/raw | Originele .eml downloaden |
| GET | /api/attachments/{id} | Bijlage downloaden |
| GET | /api/events | SSE-eventstream, stuurt event: mail bij nieuwe e-mails |
Voorbeelden
# 1. Inbox aanmaken. Lege body voor een willekeurig adres, of {"local":"abc","domain":"…"} voor een eigen adres
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. Inbox tonen (laatste 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. E-mail ophalen (inhoud en bijlagen)
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)
Fouten
Bij een fout wordt een niet-2xx-status met JSON-body teruggegeven:
{"error": "rate_limited", "message": "…"}