Öppet API
Skapa tillfälliga inkorgar och läs mejl med ett enkelt HTTP-API – perfekt för automatiserade tester och verifiering av registreringar. Alla endpoints returnerar JSON.
Autentisering
När du skapar en inkorg returneras en token. Skicka med den i efterföljande förfrågningar:
Authorization: Bearer <token>
Begränsningar
Utan API-nyckel kan varje IP skapa upp till 10 inkorgar per minut. För högre gränser, skicka en API-nyckel när du skapar:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpoints
| Metod | Sökväg | Beskrivning |
|---|---|---|
| GET | /api/domains | Lista tillgängliga domäner |
| POST | /api/mailbox | Skapa inkorg. Tom body för slumpad adress eller {"local":"abc","domain":"…"} för egen adress |
| GET | /api/mailbox | Info om aktuell inkorg |
| DELETE | /api/mailbox | Radera inkorgen och alla mejl |
| GET | /api/messages | Lista inkorgen (senaste 100) |
| GET | /api/messages/{id} | Hämta ett mejl (innehåll och bilagor) |
| DELETE | /api/messages/{id} | Radera ett mejl |
| GET | /api/messages/{id}/raw | Ladda ner rå .eml |
| GET | /api/attachments/{id} | Ladda ner en bilaga |
| GET | /api/events | SSE-händelseström, skickar event: mail vid nya mejl |
Exempel
# 1. Skapa inkorg. Tom body för slumpad adress eller {"local":"abc","domain":"…"} för egen adress
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. Lista inkorgen (senaste 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Hämta ett mejl (innehåll och bilagor)
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)
Fel
Vid fel returneras en icke-2xx-status med JSON-body:
{"error": "rate_limited", "message": "…"}