Otevřené API
Vytvářejte dočasné schránky a čtěte e-maily přes jednoduché HTTP API — ideální pro automatické testy a ověřování registrací. Všechny endpointy vracejí JSON.
Ověření
Vytvoření schránky vrátí token. Posílejte jej v dalších požadavcích:
Authorization: Bearer <token>
Limity
Bez API klíče může každá IP vytvořit až 10 schránek za minutu. Pro vyšší limity pošlete při vytváření API klíč:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpointy
| Metoda | Cesta | Popis |
|---|---|---|
| GET | /api/domains | Seznam dostupných domén |
| POST | /api/mailbox | Vytvořit schránku. Prázdné tělo pro náhodnou adresu, nebo {"local":"abc","domain":"…"} pro vlastní |
| GET | /api/mailbox | Informace o aktuální schránce |
| DELETE | /api/mailbox | Smazat schránku a všechny e-maily |
| GET | /api/messages | Seznam přijatých (posledních 100) |
| GET | /api/messages/{id} | Získat e-mail (obsah a přílohy) |
| DELETE | /api/messages/{id} | Smazat e-mail |
| GET | /api/messages/{id}/raw | Stáhnout původní .eml |
| GET | /api/attachments/{id} | Stáhnout přílohu |
| GET | /api/events | Proud událostí SSE, posílá event: mail při nových e-mailech |
Příklady
# 1. Vytvořit schránku. Prázdné tělo pro náhodnou adresu, nebo {"local":"abc","domain":"…"} pro vlastní
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. Seznam přijatých (posledních 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Získat e-mail (obsah a přílohy)
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)
Chyby
Při chybě se vrací stav jiný než 2xx s tělem JSON:
{"error": "rate_limited", "message": "…"}