Ανοιχτό API
Δημιουργήστε προσωρινές θυρίδες και διαβάστε email μέσω ενός απλού HTTP API — ιδανικό για αυτοματοποιημένα τεστ και επαλήθευση εγγραφών. Όλα τα endpoints επιστρέφουν JSON.
Πιστοποίηση
Η δημιουργία θυρίδας επιστρέφει ένα token. Στείλτε το στα επόμενα αιτήματα:
Authorization: Bearer <token>
Όρια
Χωρίς κλειδί API, κάθε IP μπορεί να δημιουργήσει έως 10 θυρίδες ανά λεπτό. Για υψηλότερα όρια, στείλτε κλειδί API κατά τη δημιουργία:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpoints
| Μέθοδος | Διαδρομή | Περιγραφή |
|---|---|---|
| GET | /api/domains | Λίστα διαθέσιμων τομέων |
| POST | /api/mailbox | Δημιουργία θυρίδας. Κενό σώμα για τυχαία διεύθυνση ή {"local":"abc","domain":"…"} για προσαρμοσμένη |
| GET | /api/mailbox | Στοιχεία τρέχουσας θυρίδας |
| DELETE | /api/mailbox | Διαγραφή θυρίδας και όλων των email |
| GET | /api/messages | Λίστα εισερχομένων (τελευταία 100) |
| GET | /api/messages/{id} | Λήψη email (περιεχόμενο και συνημμένα) |
| DELETE | /api/messages/{id} | Διαγραφή email |
| GET | /api/messages/{id}/raw | Λήψη αρχικού .eml |
| GET | /api/attachments/{id} | Λήψη συνημμένου |
| GET | /api/events | Ροή συμβάντων SSE, στέλνει event: mail σε νέα email |
Παραδείγματα
# 1. Δημιουργία θυρίδας. Κενό σώμα για τυχαία διεύθυνση ή {"local":"abc","domain":"…"} για προσαρμοσμένη
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. Λίστα εισερχομένων (τελευταία 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Λήψη email (περιεχόμενο και συνημμένα)
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)
Σφάλματα
Σε σφάλμα επιστρέφεται κατάσταση εκτός 2xx με σώμα JSON:
{"error": "rate_limited", "message": "…"}