帳戶和會員

帳戶和會員

帳戶和會員功能定義如何組織帳戶以及如何為受保護的收件匣管理員操作指派角色。 它使您可以直接控制誰可以使用每個帳戶以及哪個帳戶對每個請求處於活動狀態。

為什麼這很重要

此功能設定憑證、任務、作業、電子郵件和日誌的帳戶邊界。它使帳戶切換和成員資格中的角色分配保持明確，從而減少團隊跨父帳戶和子帳戶工作時出現的錯誤。

核心流程

用戶端首先列出可存取的帳戶，選擇活動帳戶，然後透過帳戶視圖切換儲存該選擇。它從那裡加載帳戶和會員數據，然後在該帳戶下執行帳戶或成員更改。

操作

運作	端點	目的
列出帳戶	GET /api/accounts	取得可存取的帳戶清單
搜尋帳號	POST /api/accounts/search	查詢篩選器設定的帳號
取得帳號	GET /api/accounts/:account_id	檢索帳戶詳細資料
切換活躍帳號	POST /api/account-views/switch	儲存活動帳號選擇
建立帳號	POST /api/accounts	建立 root 或子帳號
更新帳號	PATCH /api/accounts/:account_id	修改帳號欄位
刪除帳戶	DELETE /api/accounts/:account_id	刪除帳戶
會員名單	GET /api/accounts/:account_id/members	取得帳戶會員資格
新增會員	POST /api/accounts/:account_id/members	建立會員
更新會員	PATCH /api/accounts/:account_id/members/:member_id	更改角色或會員資格元資料
刪除會員	DELETE /api/accounts/:account_id/members/:member_id	撤銷帳號存取權限

關鍵數據和狀態

{
  account_id: "acc_...",
  parent_account_id: "acc_parent_...", // optional for hierarchy
  membership: {
    user_id: "uid_...",
    role: "owner" | "member" | "viewer"
  }
}

故障模式與控制

對呼叫者成員資格集之外的帳戶的請求將被拒絕，並且成員更改需要正確的角色。帳戶切換必須針對呼叫者可以存取的帳戶，且帳戶生命週期變更只能透過明確帳戶端點發生。

相關

帳戶、會員資格、收件匣管理員用戶端流程。