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:
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!
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
Mengambil semua daftar domain yang saat ini aktif di server (dibaca dari domains.txt).
curl -X GET "https://mail.mrbee.tech/api/domains" \ -H "X-Access-Token: dumbledore"
{
"success": true,
"domains": [
"mrbee.tech"
]
}
Menambahkan domain baru ke dalam daftar server secara instan tanpa perlu restart.
| Field | Tipe | Keterangan |
|---|---|---|
domain | string (wajib) | Nama domain yang ingin didaftarkan (contoh: domainku.com) |
curl -X POST "https://mail.mrbee.tech/api/domains" \
-H "X-Access-Token: dumbledore" \
-H "Content-Type: application/json" \
-d '{"domain": "domainku.com"}'
{
"success": true,
"message": "Domain domainku.com berhasil ditambahkan!",
"domains": [
"mrbee.tech",
"domainku.com"
]
}
Membuat alamat email sementara acak baru. Berlaku aktif selama 7 hari.
| Parameter | Tipe | Keterangan |
|---|---|---|
domain | string | Pilih domain spesifik (default: domain pertama). Contoh: ?domain=mrbee.tech |
curl -X GET "https://mail.mrbee.tech/api/address/new" \ -H "X-Access-Token: dumbledore"
{
"success": true,
"address": "4f9d2a1b7e@mrbee.tech",
"localpart": "4f9d2a1b7e",
"domain": "mrbee.tech",
"expires_at": "2026-10-22T01:30:00.000Z"
}
Memastikan alamat email dengan nama custom (deterministic) siap menerima pesan.
| Parameter | Tipe | Keterangan |
|---|---|---|
:user | string | Nama username/awalan email (huruf/angka/titik/strip). Contoh: budi123 |
curl -X GET "https://mail.mrbee.tech/api/address/ensure/budi123?domain=mrbee.tech" \ -H "X-Access-Token: dumbledore"
{
"success": true,
"address": "budi123@mrbee.tech",
"localpart": "budi123",
"domain": "mrbee.tech",
"expires_at": "2026-10-22T01:30:00.000Z"
}
Mengambil daftar seluruh email yang masuk ke kotak surat alamat tertentu. Digunakan untuk proses Polling OTP oleh bot.
| Parameter | Tipe | Keterangan |
|---|---|---|
:address | string | Alamat email lengkap. Contoh: budi123@mrbee.tech (URL encoded) |
curl -X GET "https://mail.mrbee.tech/api/inbox/budi123@mrbee.tech" \ -H "X-Access-Token: dumbledore"
{
"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"
}
]
}
Mengambil detail lengkap pesan email (termasuk teks plain text dan format HTML asli).
curl -X GET "https://mail.mrbee.tech/api/message/e4a719c8-3b21-4f90-9512-8921df34b120" \ -H "X-Access-Token: dumbledore"
{
"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"
}
}