Avoin API
Luo väliaikaisia postilaatikoita ja lue viestejä yksinkertaisella HTTP-rajapinnalla – sopii automaattiseen testaukseen ja rekisteröitymisten tarkistamiseen. Kaikki päätepisteet palauttavat JSONia.
Todennus
Postilaatikon luonti palauttaa tunnisteen. Lähetä se seuraavissa pyynnöissä:
Authorization: Bearer <token>
Rajoitukset
Ilman API-avainta kukin IP voi luoda enintään 10 postilaatikkoa minuutissa. Korkeampia rajoja varten lähetä API-avain luonnin yhteydessä:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Päätepisteet
| Metodi | Polku | Kuvaus |
|---|---|---|
| GET | /api/domains | Saatavilla olevat verkkotunnukset |
| POST | /api/mailbox | Luo postilaatikko. Tyhjä runko satunnaiselle osoitteelle tai {"local":"abc","domain":"…"} omalle osoitteelle |
| GET | /api/mailbox | Nykyisen postilaatikon tiedot |
| DELETE | /api/mailbox | Poista postilaatikko ja kaikki viestit |
| GET | /api/messages | Saapuneet-luettelo (uusimmat 100) |
| GET | /api/messages/{id} | Hae viesti (sisältö ja liitteet) |
| DELETE | /api/messages/{id} | Poista viesti |
| GET | /api/messages/{id}/raw | Lataa alkuperäinen .eml |
| GET | /api/attachments/{id} | Lataa liite |
| GET | /api/events | SSE-tapahtumavirta, lähettää event: mail uusista viesteistä |
Esimerkit
# 1. Luo postilaatikko. Tyhjä runko satunnaiselle osoitteelle tai {"local":"abc","domain":"…"} omalle osoitteelle
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. Saapuneet-luettelo (uusimmat 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Hae viesti (sisältö ja liitteet)
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)
Virheet
Virhetilanteessa palautetaan muu kuin 2xx-tila ja JSON-runko:
{"error": "rate_limited", "message": "…"}