Åbent API
Opret midlertidige indbakker og læs e-mails med et simpelt HTTP API – ideelt til automatiserede tests og bekræftelse af tilmeldinger. Alle endpoints returnerer JSON.
Godkendelse
Når du opretter en indbakke, returneres et token. Send det med i efterfølgende anmodninger:
Authorization: Bearer <token>
Begrænsninger
Uden API-nøgle kan hver IP oprette op til 10 indbakker i minuttet. For højere grænser skal du sende en API-nøgle ved oprettelse:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpoints
| Metode | Sti | Beskrivelse |
|---|---|---|
| GET | /api/domains | Vis tilgængelige domæner |
| POST | /api/mailbox | Opret indbakke. Tom body for en tilfældig adresse eller {"local":"abc","domain":"…"} for en valgt adresse |
| GET | /api/mailbox | Info om den aktuelle indbakke |
| DELETE | /api/mailbox | Slet indbakken og alle e-mails |
| GET | /api/messages | Vis indbakken (seneste 100) |
| GET | /api/messages/{id} | Hent en e-mail (indhold og vedhæftninger) |
| DELETE | /api/messages/{id} | Slet en e-mail |
| GET | /api/messages/{id}/raw | Download den rå .eml |
| GET | /api/attachments/{id} | Download en vedhæftning |
| GET | /api/events | SSE-hændelsesstrøm, sender event: mail ved nye e-mails |
Eksempler
# 1. Opret indbakke. Tom body for en tilfældig adresse eller {"local":"abc","domain":"…"} for en valgt adresse
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. Vis indbakken (seneste 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Hent en e-mail (indhold og vedhæftninger)
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)
Fejl
Ved fejl returneres en ikke-2xx-status med JSON-body:
{"error": "rate_limited", "message": "…"}