API aperta
Crea caselle temporanee e leggi le email con una semplice API HTTP, ideale per test automatici e verifica delle registrazioni. Tutti gli endpoint restituiscono JSON.
Autenticazione
La creazione di una casella restituisce un token. Invialo nelle richieste successive:
Authorization: Bearer <token>
Limiti di utilizzo
Senza chiave API, ogni IP può creare fino a 10 caselle al minuto. Per limiti più alti, invia una chiave API durante la creazione:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpoint
| Metodo | Percorso | Descrizione |
|---|---|---|
| GET | /api/domains | Elenca i domini disponibili |
| POST | /api/mailbox | Crea una casella. Body vuoto per un indirizzo casuale, oppure {"local":"abc","domain":"…"} per uno personalizzato |
| GET | /api/mailbox | Informazioni sulla casella attuale |
| DELETE | /api/mailbox | Elimina la casella e tutte le sue email |
| GET | /api/messages | Elenca la posta in arrivo (ultime 100) |
| GET | /api/messages/{id} | Ottieni un'email (corpo e allegati) |
| DELETE | /api/messages/{id} | Elimina un'email |
| GET | /api/messages/{id}/raw | Scarica il .eml originale |
| GET | /api/attachments/{id} | Scarica un allegato |
| GET | /api/events | Flusso di eventi SSE, invia event: mail all'arrivo di nuove email |
Esempi
# 1. Crea una casella. Body vuoto per un indirizzo casuale, oppure {"local":"abc","domain":"…"} per uno personalizzato
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. Elenca la posta in arrivo (ultime 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Ottieni un'email (corpo e allegati)
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)
Errori
In caso di errore viene restituito uno stato non 2xx con corpo JSON:
{"error": "rate_limited", "message": "…"}