Profile & Resource Quota
Frog Cloud memisahkan pengelolaan kredensial (Auth) dan informasi pribadi (Profile) untuk meningkatkan performa sistem. Dokumentasi ini mencakup cara Frontend merender data pribadi pelanggan, kuota layanan (seperti limit VM), serta pengaturan preferensi notifikasi.
1. Menarik Info Singkat Dasbor (User Info)
Saat pelanggan pertama kali mendarat di halaman utama Dasbor, Frontend membutuhkan ringkasan data yang cepat tanpa harus memuat seluruh entitas profil.
GET /api/inf
Respons (200 OK): Mereturn informasi vital seperti Nama Lengkap pengguna, Saldo Dompet (Balance) saat ini, kuota limit terpakai, dan hitungan jumlah notifikasi yang belum dibaca.
2. Mengelola Profil Pribadi & Bisnis
Di halaman Pengaturan Profil, pelanggan dapat melengkapi data identitas mereka (seperti Alamat atau Nama Perusahaan). Informasi ini kelak akan digunakan sistem saat mencetak dokumen hukum seperti Invoice.
Melihat Profil Saat Ini
GET /api/customer/profile
Menyimpan Perubahan Profil
PATCH /api/customer/profile
Content-Type: application/json
{
"first_name": "Mas",
"last_name": "Bram",
"company_name": "PT. Awan Data",
"address": "Jl. Sudirman No. 1"
}
3. Limit Kuota Resource (Resource Limits)
Setiap Customer memiliki "Jatah" atau batasan maksimal pembuatan layanan Cloud (contoh: maksimal 5 Virtual Machine, atau maksimal 2 IP Publik) untuk mencegah penyalahgunaan (Abuse/Spam).
Frontend dapat menggunakan API ini untuk menampilkan grafik batang (progress bar) yang menunjukkan kuota terpakai vs kuota maksimal di layar Billing atau Dashboard.
GET /api/customer/resource
Respons (200 OK):
{
"data": {
"max_vm": 10,
"current_vm": 2,
"max_ip": 5,
"current_ip": 1
}
}
4. Pengaturan Notifikasi (Notification Settings)
Pelanggan diberikan kontrol privasi untuk mematikan atau menghidupkan notifikasi promosi pemasaran (Marketing), laporan tagihan harian, dll.
PATCH /api/customer/profile/notification-setting
Content-Type: application/json
{
"allow_marketing_email": false,
"allow_billing_reminder": true
}