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
| Metode | Path | Deskripsi |
|---|---|---|
| GET | /api/domains | Daftar domain yang tersedia |
| POST | /api/mailbox | Buat kotak masuk. Body kosong untuk alamat acak, atau {"local":"abc","domain":"…"} untuk alamat khusus |
| GET | /api/mailbox | Info kotak masuk saat ini |
| DELETE | /api/mailbox | Hapus kotak masuk dan semua email |
| GET | /api/messages | Daftar kotak masuk (100 terbaru) |
| GET | /api/messages/{id} | Ambil email (isi dan lampiran) |
| DELETE | /api/messages/{id} | Hapus email |
| GET | /api/messages/{id}/raw | Unduh .eml asli |
| GET | /api/attachments/{id} | Unduh lampiran |
| GET | /api/events | Aliran 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": "…"}