Nyílt API
Hozz létre ideiglenes postafiókokat és olvasd a leveleket egy egyszerű HTTP API-val — ideális automatizált tesztekhez és regisztrációk ellenőrzéséhez. Minden végpont JSON-t ad vissza.
Hitelesítés
Postafiók létrehozásakor tokent kapsz. Küldd el a további kérésekben:
Authorization: Bearer <token>
Korlátok
API-kulcs nélkül egy IP percenként legfeljebb 10 postafiókot hozhat létre. Magasabb korlátért küldj API-kulcsot létrehozáskor:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Végpontok
| Metódus | Útvonal | Leírás |
|---|---|---|
| GET | /api/domains | Elérhető domainek listája |
| POST | /api/mailbox | Postafiók létrehozása. Üres törzs véletlen címhez, vagy {"local":"abc","domain":"…"} egyedi címhez |
| GET | /api/mailbox | Az aktuális postafiók adatai |
| DELETE | /api/mailbox | A postafiók és minden levél törlése |
| GET | /api/messages | Beérkezett levelek listája (utolsó 100) |
| GET | /api/messages/{id} | Levél lekérése (tartalom és mellékletek) |
| DELETE | /api/messages/{id} | Levél törlése |
| GET | /api/messages/{id}/raw | Eredeti .eml letöltése |
| GET | /api/attachments/{id} | Melléklet letöltése |
| GET | /api/events | SSE eseményfolyam, új levélnél event: mail üzenetet küld |
Példák
# 1. Postafiók létrehozása. Üres törzs véletlen címhez, vagy {"local":"abc","domain":"…"} egyedi címhez
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. Beérkezett levelek listája (utolsó 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Levél lekérése (tartalom és mellékletek)
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)
Hibák
Hiba esetén nem 2xx státuszkód és JSON törzs érkezik:
{"error": "rate_limited", "message": "…"}