Kembali ke Temp Mail

Dokumentasi API

Temp Mail menyediakan API publik sederhana untuk membuat alamat email sementara dan membaca kotak masuknya secara programatis. Tanpa kunci API, tanpa pendaftaran, dan CORS terbuka untuk semua origin.

Basis URL: https://temp.udi.web.id — bisa diganti pintu temp. dari domain mana pun di bawah ini; semua pintu membaca kotak masuk yang sama.

Domain yang didukung

Semua alamat pada domain berikut langsung menerima email (catch-all). Alamat tidak perlu dibuat terlebih dahulu; memakai nama apa pun langsung bisa menerima pesan.

1. Buat alamat acak

GET /api/new-email

Menghasilkan alamat acak yang mudah dibaca manusia. Parameter opsional: domain — salah satu domain yang didukung; bawaan udi.web.id.

curl "https://temp.udi.web.id/api/new-email?domain=udi.web.id"
{ "email": "bima.pratama@udi.web.id", "domain": "udi.web.id" }

2. Daftar pesan di kotak masuk

GET /api/messages?email=ALAMAT

Parameter wajib: email — alamat lengkap yang ingin dibaca. Balasan berisi daftar ringkas pesan, terbaru di depan, maksimal 50 pesan. Setiap ringkasan memuat id, from, fromName, to, subject, date (ISO 8601), otp (kode angka yang terdeteksi, bila ada), dan snippet.

curl "https://temp.udi.web.id/api/messages?email=bima.pratama@udi.web.id"
{ "messages": [ { "id": "1735689600000_ab12cd", "from": "noreply@contoh.id", "subject": "Kode verifikasi", "otp": "482913" } ] }

Tanpa parameter email, server membalas status 400.

3. Baca satu pesan penuh

GET /api/message?id=ID

Parameter wajib: id — id dari daftar pesan. Balasannya adalah ringkasan pesan ditambah isi penuh text dan html. Pesan yang sudah kedaluwarsa dibalas status 404.

curl "https://temp.udi.web.id/api/message?id=1735689600000_ab12cd"

4. Hapus satu pesan

DELETE /api/message?id=ID&email=ALAMAT

Menghapus satu pesan dari kotak masuk alamat tersebut. Balasan: { "success": true }.

curl -X DELETE "https://temp.udi.web.id/api/message?id=1735689600000_ab12cd&email=bima.pratama@udi.web.id"

5. Kosongkan kotak masuk

DELETE /api/messages?email=ALAMAT

Menghapus seluruh daftar pesan milik alamat tersebut. Balasan: { "success": true }.

curl -X DELETE "https://temp.udi.web.id/api/messages?email=bima.pratama@udi.web.id"

Catatan