API Developer VookMail
Buat kotak masuk sementara dan baca pesan dari aplikasi Anda sendiri dengan REST API yang sederhana. Responsnya berformat JSON.
Autentikasi
Kirim kunci API Anda di header Authorization. Kunci diterbitkan oleh pemilik situs.
curl https://www.vookmail.com/api/v1/domains \
-H "Authorization: Bearer vk_your_key"
Endpoint
URL dasar: https://www.vookmail.com/api/v1
| Metode | Path | Deskripsi |
|---|---|---|
| GET | /domains | Daftar domain yang tersedia |
| POST | /mailboxes | Buat kotak masuk. Body: nama pengguna dan domain, keduanya opsional |
| GET | /mailboxes/{address} | Detail kotak masuk dan masa kedaluwarsa |
| POST | /mailboxes/{address}/extend | Perpanjang masa aktif kotak masuk |
| DELETE | /mailboxes/{address} | Tutup kotak masuk dan hapus pesannya |
| GET | /mailboxes/{address}/messages?after={id} | Daftar pesan beserta kode dan tautan yang terdeteksi |
| GET | /mailboxes/{address}/messages/{id} | Baca satu pesan: HTML yang sudah dibersihkan, teks, dan lampiran |
| DELETE | /mailboxes/{address}/messages/{id} | Hapus satu pesan |
| GET | /mailboxes/{address}/messages/{id}/attachments/{attachment} | Unduh lampiran |
Contoh
curl -X POST https://www.vookmail.com/api/v1/mailboxes \
-H "Authorization: Bearer vk_your_key" \
-H "Content-Type: application/json" \
-d '{"username":"myapp"}'
{"address":"myapp@example.com","token":"...","expires_at":"2026-10-31T12:00:00+00:00"}
Error dan batas
Error mengembalikan status HTTP beserta error.code dan error.message. Setiap kunci memiliki batas per menit; jika terlampaui, status 429 dikembalikan.
