✉ Temp Mail

Åpent API

Opprett midlertidige innbokser og les e-post med et enkelt HTTP-API – ideelt for automatiserte tester og bekreftelse av registreringer. Alle endepunkter returnerer JSON.

Autentisering

Når du oppretter en innboks, returneres et token. Send det med i senere forespørsler:

Authorization: Bearer <token>

Begrensninger

Uten API-nøkkel kan hver IP opprette opptil 10 innbokser per minutt. For høyere grenser, send en API-nøkkel ved oppretting:

X-API-Key: tm_xxxxxxxxxxxxxxxx

Endepunkter

MetodeStiBeskrivelse
GET/api/domainsVis tilgjengelige domener
POST/api/mailboxOpprett innboks. Tom body for tilfeldig adresse, eller {"local":"abc","domain":"…"} for egen adresse
GET/api/mailboxInfo om gjeldende innboks
DELETE/api/mailboxSlett innboksen og all e-post
GET/api/messagesVis innboksen (siste 100)
GET/api/messages/{id}Hent en e-post (innhold og vedlegg)
DELETE/api/messages/{id}Slett en e-post
GET/api/messages/{id}/rawLast ned rå .eml
GET/api/attachments/{id}Last ned et vedlegg
GET/api/eventsSSE-hendelsesstrøm, sender event: mail ved ny e-post

Eksempler

# 1. Opprett innboks. Tom body for tilfeldig adresse, eller {"local":"abc","domain":"…"} for egen adresse
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
  -H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}

# 2. Vis innboksen (siste 100)
curl -s https://www.temp-mail.cc/api/messages \
  -H 'Authorization: Bearer <token>'

# 3. Hent en e-post (innhold og vedlegg)
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)

Feil

Ved feil returneres en ikke-2xx-status med JSON-body:

{"error": "rate_limited", "message": "…"}

← Til forsiden