Akun dan Anggota
Fitur akun dan anggota menentukan cara akun diatur dan cara penetapan peran untuk operasi Inbox Manager yang dilindungi. Ini memberi Anda kendali langsung atas siapa yang dapat menggunakan setiap akun dan akun mana yang aktif untuk setiap permintaan.
Mengapa Ini Penting
Fitur ini menetapkan batas akun untuk kredensial, tugas, pekerjaan, email, dan log. Hal ini membuat peralihan akun tetap eksplisit dan penetapan peran dalam keanggotaan, sehingga mengurangi kesalahan saat tim bekerja di akun induk dan anak.
Aliran Inti
Klien terlebih dahulu membuat daftar akun yang dapat diakses, memilih akun yang aktif, dan menyimpan pilihan tersebut melalui peralihan tampilan akun. Dari sana ia memuat data akun dan keanggotaan, lalu melakukan perubahan akun atau anggota di bawah akun itu.
Operasi
| Operasi | Endpoint | Tujuan |
|---|---|---|
| Daftar akun | GET /api/accounts |
Ambil daftar akun yang dapat diakses |
| Cari akun | POST /api/accounts/search |
Akun kueri disetel berdasarkan filter |
| Dapatkan akun | GET /api/accounts/:account_id |
Ambil detail akun |
| Ganti akun aktif | POST /api/account-views/switch |
Simpan pilihan akun aktif |
| Buat akun | POST /api/accounts |
Buat akun root atau anak |
| Perbarui akun | PATCH /api/accounts/:account_id |
Ubah bidang akun |
| Hapus akun | DELETE /api/accounts/:account_id |
Hapus akun |
| Daftar anggota | GET /api/accounts/:account_id/members |
Ambil keanggotaan akun |
| Tambahkan anggota | POST /api/accounts/:account_id/members |
Buat keanggotaan |
| Perbarui anggota | PATCH /api/accounts/:account_id/members/:member_id |
Ubah metadata peran atau keanggotaan |
| Hapus anggota | DELETE /api/accounts/:account_id/members/:member_id |
Cabut akses akun |
Data dan Status Utama
{
account_id: "acc_...",
parent_account_id: "acc_parent_...", // optional for hierarchy
membership: {
user_id: "uid_...",
role: "owner" | "member" | "viewer"
}
}Mode dan Kontrol Kegagalan
Permintaan akun di luar kumpulan keanggotaan penelepon ditolak, dan perubahan anggota memerlukan peran yang tepat. Peralihan akun harus menargetkan akun yang dapat diakses oleh penelepon, dan perubahan siklus hidup akun hanya terjadi melalui endpoint akun yang eksplisit.