Açık API
Basit bir HTTP API ile geçici kutular oluşturun ve e-postaları okuyun; otomatik testler ve kayıt doğrulaması için idealdir. Tüm uç noktalar JSON döndürür.
Kimlik doğrulama
Kutu oluşturulduğunda bir token döner. Sonraki isteklerde gönderin:
Authorization: Bearer <token>
Hız sınırları
API anahtarı olmadan her IP dakikada en fazla 10 kutu oluşturabilir. Daha yüksek sınırlar için oluştururken API anahtarı gönderin:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Uç noktalar
| Yöntem | Yol | Açıklama |
|---|---|---|
| GET | /api/domains | Kullanılabilir alan adlarını listele |
| POST | /api/mailbox | Kutu oluştur. Rastgele adres için boş gövde veya özel adres için {"local":"abc","domain":"…"} |
| GET | /api/mailbox | Geçerli kutu bilgisi |
| DELETE | /api/mailbox | Kutuyu ve tüm e-postaları sil |
| GET | /api/messages | Gelen kutusunu listele (son 100) |
| GET | /api/messages/{id} | E-postayı getir (içerik ve ekler) |
| DELETE | /api/messages/{id} | E-postayı sil |
| GET | /api/messages/{id}/raw | Ham .eml dosyasını indir |
| GET | /api/attachments/{id} | Eki indir |
| GET | /api/events | SSE olay akışı, yeni e-postada event: mail gönderir |
Örnekler
# 1. Kutu oluştur. Rastgele adres için boş gövde veya özel adres için {"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. Gelen kutusunu listele (son 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. E-postayı getir (içerik ve ekler)
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)
Hatalar
Hata durumunda 2xx dışı bir durum kodu ve JSON gövdesi döner:
{"error": "rate_limited", "message": "…"}