✉ Email Sementara

API Terbuka

Buat kotak masuk sementara dan baca email dengan HTTP API sederhana, ideal untuk pengujian otomatis dan verifikasi pendaftaran. Semua endpoint mengembalikan JSON.

Autentikasi

Membuat kotak masuk akan mengembalikan token. Kirimkan pada permintaan berikutnya:

Authorization: Bearer <token>

Batas penggunaan

Tanpa API key, setiap IP dapat membuat hingga 10 kotak masuk per menit. Untuk batas lebih tinggi, kirim API key saat membuat:

X-API-Key: tm_xxxxxxxxxxxxxxxx

Endpoint

MetodePathDeskripsi
GET/api/domainsDaftar domain yang tersedia
POST/api/mailboxBuat kotak masuk. Body kosong untuk alamat acak, atau {"local":"abc","domain":"…"} untuk alamat khusus
GET/api/mailboxInfo kotak masuk saat ini
DELETE/api/mailboxHapus kotak masuk dan semua email
GET/api/messagesDaftar kotak masuk (100 terbaru)
GET/api/messages/{id}Ambil email (isi dan lampiran)
DELETE/api/messages/{id}Hapus email
GET/api/messages/{id}/rawUnduh .eml asli
GET/api/attachments/{id}Unduh lampiran
GET/api/eventsAliran event SSE, mengirim event: mail saat ada email baru

Contoh

# 1. Buat kotak masuk. Body kosong untuk alamat acak, atau {"local":"abc","domain":"…"} untuk alamat khusus
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
  -H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}

# 2. Daftar kotak masuk (100 terbaru)
curl -s https://www.temp-mail.cc/api/messages \
  -H 'Authorization: Bearer <token>'

# 3. Ambil email (isi dan lampiran)
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)

Kesalahan

Saat terjadi kesalahan, status non-2xx dikembalikan dengan body JSON:

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

← Kembali ke beranda