Akun dan Anggota

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.

Terkait

Akun, Keanggotaan, Inbox Manager Alur Klien.