API deschis
Creează căsuțe temporare și citește emailuri printr-un API HTTP simplu, ideal pentru teste automate și verificarea înscrierilor. Toate endpointurile returnează JSON.
Autentificare
Crearea unei căsuțe returnează un token. Trimite-l în cererile următoare:
Authorization: Bearer <token>
Limite
Fără cheie API, fiecare IP poate crea până la 10 căsuțe pe minut. Pentru limite mai mari, trimite o cheie API la creare:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpointuri
| Metodă | Cale | Descriere |
|---|---|---|
| GET | /api/domains | Lista domeniilor disponibile |
| POST | /api/mailbox | Creează o căsuță. Corp gol pentru adresă aleatorie sau {"local":"abc","domain":"…"} pentru una personalizată |
| GET | /api/mailbox | Informații despre căsuța curentă |
| DELETE | /api/mailbox | Șterge căsuța și toate emailurile |
| GET | /api/messages | Lista inbox (ultimele 100) |
| GET | /api/messages/{id} | Obține un email (conținut și atașamente) |
| DELETE | /api/messages/{id} | Șterge un email |
| GET | /api/messages/{id}/raw | Descarcă .eml original |
| GET | /api/attachments/{id} | Descarcă un atașament |
| GET | /api/events | Flux de evenimente SSE, trimite event: mail la emailuri noi |
Exemple
# 1. Creează o căsuță. Corp gol pentru adresă aleatorie sau {"local":"abc","domain":"…"} pentru una personalizată
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 inbox (ultimele 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Obține un email (conținut și atașamente)
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)
Erori
La eroare se returnează un status diferit de 2xx cu corp JSON:
{"error": "rate_limited", "message": "…"}