Otvoreni API
Pravite privremena sandučad i čitajte mejlove preko jednostavnog HTTP API-ja — idealno za automatsko testiranje i proveru registracija. Svi endpointi vraćaju JSON.
Autentifikacija
Pravljenje sandučeta vraća token. Šaljite ga u narednim zahtevima:
Authorization: Bearer <token>
Ograničenja
Bez API ključa, svaka IP adresa može napraviti do 10 sandučadi u minutu. Za veća ograničenja pošaljite API ključ pri pravljenju:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpointi
| Metod | Putanja | Opis |
|---|---|---|
| GET | /api/domains | Lista dostupnih domena |
| POST | /api/mailbox | Napravi sanduče. Prazno telo za nasumičnu adresu ili {"local":"abc","domain":"…"} za sopstvenu |
| GET | /api/mailbox | Podaci o trenutnom sandučetu |
| DELETE | /api/mailbox | Obriši sanduče i sve mejlove |
| GET | /api/messages | Lista primljenih (poslednjih 100) |
| GET | /api/messages/{id} | Preuzmi mejl (sadržaj i prilozi) |
| DELETE | /api/messages/{id} | Obriši mejl |
| GET | /api/messages/{id}/raw | Preuzmi originalni .eml |
| GET | /api/attachments/{id} | Preuzmi prilog |
| GET | /api/events | SSE tok događaja, šalje event: mail pri novim mejlovima |
Primeri
# 1. Napravi sanduče. Prazno telo za nasumičnu adresu ili {"local":"abc","domain":"…"} za sopstvenu
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 primljenih (poslednjih 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Preuzmi mejl (sadržaj i prilozi)
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)
Greške
Pri grešci se vraća status različit od 2xx sa JSON telom:
{"error": "rate_limited", "message": "…"}