⚡ Temp Mail API Documentation

Domain: munir-vip.com · Subdomain tersedia: 130 variasi

Format alamat: namaemail@subdomain.munir-vip.com

Base URL: https://mail.munir-vip.com
Auth: tidak diperlukan (API key belum diaktifkan). Jika suatu saat diaktifkan, kirim header x-api-key atau query ?key=.
Mailbox: auto-create — email masuk ke alamat apa pun langsung diterima tanpa perlu registrasi manual.

Ringkasan Endpoint

Method	Endpoint	Fungsi
POST	`/api/new`	Buat/ambil alamat email baru (acak / round-robin / kustom)
GET	`/api/mails/:address`	Daftar email masuk (+ OTP terdeteksi)
GET	`/api/mails/:address/:id`	Detail email (body, HTML, OTP, lampiran, links)
DELETE	`/api/mails/:address/:id`	Hapus satu email
DELETE	`/api/mails/:address`	Kosongkan inbox
DELETE	`/api/address/:address`	Hapus mailbox beserta semua emailnya
GET	`/api/subdomains`	Daftar 130 subdomain yang tersedia
GET	`/health`	Status service

1. Buat Alamat Baru

POST /api/new

Body JSON semuanya opsional:

Field	Default	Keterangan
`name`	8 karakter acak	Nama email (a-z, 0-9)
`subdomain`	acak dari 130 variasi	Subdomain yang diinginkan; jika diisi, bypass rotasi
`rotate`	`random`	`"seq"` = round-robin berurutan (counter persist di D1)

🎲 Mode acak (default)

curl -X POST https://mail.munir-vip.com/api/new \
  -H "Content-Type: application/json" -d '{}'

→ {"success":true,"address":"x8k2m9q1@edge.munir-vip.com","rotate":"random",...}

🔄 Mode round-robin (berurutan)

curl -X POST "https://mail.munir-vip.com/api/new?rotate=seq"

Urutan maju 1 langkah tiap request: mail → inbox → temp → drop → … setelah urutan terakhir kembali ke awal. Bisa juga via body: {"rotate":"seq"}.

✏️ Kustom nama & subdomain

curl -X POST https://mail.munir-vip.com/api/new \
  -H "Content-Type: application/json" \
  -d '{"name":"budi","subdomain":"matrix"}'

→ budi@matrix.munir-vip.com

2. Lihat Daftar Email Masuk

GET /api/mails/:address

curl https://mail.munir-vip.com/api/mails/budi@matrix.munir-vip.com

Maks 50 email terbaru. Field code berisi OTP yang terdeteksi otomatis (dideteksi dari subject/body/HTML, format bebas digit atau ber-strip seperti 204-567).

3. Detail Satu Email

GET /api/mails/:address/:id

curl https://mail.munir-vip.com/api/mails/budi@matrix.munir-vip.com/<EMAIL_ID>

Berisi text, html lengkap, attachments, links, dan code (OTP).

4. Hapus Email

DELETE satu email: /api/mails/:address/:id

curl -X DELETE https://mail.munir-vip.com/api/mails/budi@matrix.munir-vip.com/<EMAIL_ID>

DELETE kosongkan inbox: /api/mails/:address

curl -X DELETE https://mail.munir-vip.com/api/mails/budi@matrix.munir-vip.com

DELETE hapus mailbox: /api/address/:address

curl -X DELETE https://mail.munir-vip.com/api/address/budi@matrix.munir-vip.com

5. Daftar Subdomain

GET /api/subdomains

curl https://mail.munir-vip.com/api/subdomains

→ {"count": 130, "base_domain": "munir-vip.com", "subdomains": ["apaaja", "mail", "inbox", ...]}

6. Web UI

Buka https://mail.munir-vip.com/ untuk dashboard: generate acak, pilih subdomain manual (dengan autocomplete), salin alamat, baca email HTML/text, salin OTP 1-klik, auto-refresh tiap 4 detik.