Dokumentasi REST API

GET/api/email/{domain}/{user}/

Dapatkan daftar email pengguna yang diberi nomor halaman. Respons daftar hanya berisi metadata (no body / html_body).

Parameter	Lokasi	Keterangan
domain	jalur	Domain email, mis. example.com
user	jalur	Nama pengguna, mis. testuser
page	permintaan, opsional	Nomor halaman (default 1)
limit	permintaan, opsional	Item per halaman (default 20, maksimum 100)

curl -X GET "https://BASE_URL/api/email/example.com/testuser/?page=1&limit=20"

{
  "emails": [
    {
      "id": 123,
      "subject": "Welcome",
      "sender": "[email protected]",
      "date": "2026-09-30T10:30:00.000Z",
      "has_attachments": false,
      "size": 1234
    }
  ],
  "total": 5,
  "page": 1,
  "limit": 20,
  "has_more": false
}

GET/api/email/{domain}/{user}/{email_id}

Dapatkan detail lengkap email.

curl -X GET "https://BASE_URL/api/email/example.com/testuser/123"

DELETE/api/email/{domain}/{user}/{email_id}

Hapus email tertentu.

curl -X DELETE "https://BASE_URL/api/email/example.com/testuser/123"

{ "status": "deleted" }

POST/api/add-domain/{domain}

Tambahkan domain baru atau perbarui status online domain yang ada. Domain harus memiliki data MX yang menunjuk ke nama host sistem agar dapat diterima (status added, is_online: true).

curl -X POST "https://BASE_URL/api/add-domain/newdomain.com"

// Berhasil ditambahkan
{ "status": "added", "domain": "newdomain.com", "is_online": true }

// Domain yang ada: perbarui statusnya
{ "status": "updated", "domain": "newdomain.com", "is_online": false }

GET/api/all-domains/ & /api/random-domains/

Semua domain online (pribadi, diperlukan token):

curl -X GET "https://BASE_URL/api/all-domains/" \
  -H "X-Domain-Token: YOUR_TOKEN"

Domain online acak (publik):

curl -X GET "https://BASE_URL/api/random-domains/?limit=10"

{ "domains": ["domain1.com", "domain2.com"], "total": 2 }

GET/api/check-mx/{domain}

Periksa apakah domain memiliki data MX valid yang mengarah ke sistem.

curl -X GET "https://BASE_URL/api/check-mx/example.com"

{ "result": "online" }   // atau "offline"

Penanganan kesalahan

Kode	Arti
200	Kesuksesan
400	Permintaan tidak valid (misalnya domain/email salah)
401	Token tidak ada atau tidak valid untuk titik akhir privat
404	Email tidak ditemukan
429	Batas tarif terlampaui

{ "detail": "Domain not found" }

Catatan penting

• Alamat email harus menggunakan format [email protected]
• Hanya domain dengan data MX yang valid yang memiliki status "online".
• Email dan domain yang tidak aktif secara otomatis dihapus setelahnya 3 hari
• Layanan saja menerima email — pengiriman dan relai SMTP tidak didukung
• API menerapkan batas kecepatan per IP
• Periode retensi 3 hari berlaku untuk layanan langsung; pencadangan mungkin menyimpan salinan lebih lama. Penghapusan permanen dari semua salinan tidak dijamin pada saat itu.
• Kotak masuk domain khusus tetap bersifat publik dan mungkin diblokir oleh layanan pihak ketiga. Penerimaan dan pengiriman tidak dijamin.