✉ Temp Mail

Ανοιχτό 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": "…"}

← Αρχική σελίδα