← Kembali ke Tampilan Kotak Masuk

MrBee Mail API Reference

Dokumentasi resmi REST API untuk layanan disposable temp-mail MrBee Mail (https://mail.mrbee.tech). API ini dirancang 100% kompatibel dengan arsitektur bot otomasi (seperti bot pendaftaran, ekstraksi OTP verifikasi, dan rotasi email).

💡 Integrasi Bot & AI (Siap Pakai 100%)

Pilih format yang Anda butuhkan di bawah: copy prompt untuk chat AI, atau langsung copy script helper Python / Node.js.

Saya memiliki mail server disposable / temporary email pribadi dengan REST API:
- Base URL: https://mail.mrbee.tech
- Wajib Auth Header: X-Access-Token: dumbledore

Spesifikasi Endpoint untuk Bot Otomasi:
1. Buat Alamat Email Baru (Acak):
   GET https://mail.mrbee.tech/api/address/new (opsional: ?domain=mrbee.tech)
   Response JSON: { "success": true, "address": "abc123@mrbee.tech" }

2. Buat Alamat Email dengan Nama Custom:
   GET https://mail.mrbee.tech/api/address/ensure/:username?domain=mrbee.tech
   Response JSON: { "success": true, "address": "username@mrbee.tech" }

3. Polling Inbox untuk Mengambil OTP:
   GET https://mail.mrbee.tech/api/inbox/:address
   Response JSON:
   {
     "success": true,
     "count": 1,
     "emails": [
       {
         "id": "msg-uuid",
         "sender": "noreply@service.com",
         "subject": "Kode Verifikasi",
         "otp": "829104",
         "received_at": "2026-10-15T01:25:30.000Z"
       }
     ]
   }
   *Penting: Mail server MrBee sudah otomatis mengekstrak angka OTP 4-8 digit ke field "otp". Bot cukup membaca response.emails[0].otp tanpa perlu parsing regex sendiri.

4. Ambil Detail Pesan Lengkap:
   GET https://mail.mrbee.tech/api/message/:id

Tolong integrasikan API ini ke dalam alur bot saya: generate email -> isi form -> polling OTP tiap 3 detik (timeout 60s) -> ambil kode OTP.

Autentikasi (Security Header)

Semua request HTTP API wajib menyertakan header X-Access-Token atau query parameter ?api_key=....

Metode Header / Parameter Contoh Nilai
HTTP Header (Direkomendasikan) X-Access-Token dumbledore
Bearer Token Authorization Bearer dumbledore
URL Query Parameter api_key ?api_key=dumbledore

🌐 Panduan Menambah Domain Baru (Custom Domain)

Anda atau pengguna lain dapat menghubungkan domain pribadi apapun (contoh: domainku.com atau subdomain temp.namaku.id) ke server MrBee Mail agar bisa menerima email dan kode OTP secara mandiri.

Langkah 1: Atur DNS Record di Registrar Domain Anda

Masuk ke dashboard penyedia domain Anda (Cloudflare, Niagahoster, Namecheap, GoDaddy, dll), lalu tambahkan record MX berikut:

Tipe Record Name / Host Mail Server / Target Prioritas (Priority)
MX @ (atau nama subdomain) mail.mrbee.tech 10
TXT (Opsional SPF) @ v=spf1 mx ~all Auto / 3600

Langkah 2: Daftarkan Domain ke Server MrBee Mail

Pilih salah satu dari 2 cara mudah di bawah:

Cara A: Lewat Terminal VPS (Untuk Pemilik Server)

Cukup tambahkan nama domain ke file /opt/mrbee-mail/domains.txt:

echo "domainku.com" >> /opt/mrbee-mail/domains.txt
*Server langsung membaca otomatis — TIDAK perlu restart PM2!
Cara B: Lewat REST API (Bisa Otomatis via Bot / Script)

Kirim request HTTP POST ke endpoint /api/domains:

curl -X POST "https://mail.mrbee.tech/api/domains" \
  -H "X-Access-Token: dumbledore" \
  -H "Content-Type: application/json" \
  -d '{"domain": "domainku.com"}'

Langkah 3: Selesai & Langsung Siap Pakai!

Setelah terdaftar:
1. Domain baru akan langsung muncul di menu dropdown halaman utama MrBee Mail.
2. Bot dapat membuat email khusus domain tersebut: GET /api/address/new?domain=domainku.com.
3. Setiap email yang dikirim ke alamat *@domainku.com akan otomatis tertangkap oleh SMTP server dan kodenya langsung bisa dibaca via web maupun API!

Endpoints API


GET /api/domains

Mengambil semua daftar domain yang saat ini aktif di server (dibaca dari domains.txt).

Contoh Request cURL
curl -X GET "https://mail.mrbee.tech/api/domains" \
  -H "X-Access-Token: dumbledore"
Contoh Response (JSON)
{
  "success": true,
  "domains": [
    "mrbee.tech"
  ]
}
POST /api/domains

Menambahkan domain baru ke dalam daftar server secara instan tanpa perlu restart.

Request Body (JSON)
FieldTipeKeterangan
domainstring (wajib)Nama domain yang ingin didaftarkan (contoh: domainku.com)
Contoh Request cURL
curl -X POST "https://mail.mrbee.tech/api/domains" \
  -H "X-Access-Token: dumbledore" \
  -H "Content-Type: application/json" \
  -d '{"domain": "domainku.com"}'
Contoh Response (JSON)
{
  "success": true,
  "message": "Domain domainku.com berhasil ditambahkan!",
  "domains": [
    "mrbee.tech",
    "domainku.com"
  ]
}
GET /api/address/new

Membuat alamat email sementara acak baru. Berlaku aktif selama 7 hari.

Query Parameters (Opsional)
ParameterTipeKeterangan
domainstringPilih domain spesifik (default: domain pertama). Contoh: ?domain=mrbee.tech
Contoh Request cURL
curl -X GET "https://mail.mrbee.tech/api/address/new" \
  -H "X-Access-Token: dumbledore"
Contoh Response (JSON)
{
  "success": true,
  "address": "4f9d2a1b7e@mrbee.tech",
  "localpart": "4f9d2a1b7e",
  "domain": "mrbee.tech",
  "expires_at": "2026-10-22T01:30:00.000Z"
}
GET /api/address/ensure/:user

Memastikan alamat email dengan nama custom (deterministic) siap menerima pesan.

Path Parameters (Wajib)
ParameterTipeKeterangan
:userstringNama username/awalan email (huruf/angka/titik/strip). Contoh: budi123
Contoh Request cURL
curl -X GET "https://mail.mrbee.tech/api/address/ensure/budi123?domain=mrbee.tech" \
  -H "X-Access-Token: dumbledore"
Contoh Response (JSON)
{
  "success": true,
  "address": "budi123@mrbee.tech",
  "localpart": "budi123",
  "domain": "mrbee.tech",
  "expires_at": "2026-10-22T01:30:00.000Z"
}
GET /api/inbox/:address

Mengambil daftar seluruh email yang masuk ke kotak surat alamat tertentu. Digunakan untuk proses Polling OTP oleh bot.

Path Parameters (Wajib)
ParameterTipeKeterangan
:addressstringAlamat email lengkap. Contoh: budi123@mrbee.tech (URL encoded)
Contoh Request cURL
curl -X GET "https://mail.mrbee.tech/api/inbox/budi123@mrbee.tech" \
  -H "X-Access-Token: dumbledore"
Contoh Response (JSON)
{
  "success": true,
  "count": 1,
  "emails": [
    {
      "id": "e4a719c8-3b21-4f90-9512-8921df34b120",
      "sender": "noreply@cgv.id",
      "subject": "Kode Verifikasi Akun CGV",
      "otp": "829104",
      "received_at": "2026-10-15T01:25:30.000Z"
    }
  ]
}
GET /api/message/:id

Mengambil detail lengkap pesan email (termasuk teks plain text dan format HTML asli).

Contoh Request cURL
curl -X GET "https://mail.mrbee.tech/api/message/e4a719c8-3b21-4f90-9512-8921df34b120" \
  -H "X-Access-Token: dumbledore"
Contoh Response (JSON)
{
  "success": true,
  "email": {
    "id": "e4a719c8-3b21-4f90-9512-8921df34b120",
    "address": "budi123@mrbee.tech",
    "sender": "noreply@cgv.id",
    "subject": "Kode Verifikasi Akun CGV",
    "otp": "829104",
    "text": "Halo Budi,\nKode verifikasi Anda adalah: 829104",
    "html": "

Halo Budi,
Kode verifikasi Anda adalah: 829104

", "received_at": "2026-10-15T01:25:30.000Z" } }