บัญชีและสมาชิก

#บัญชีและสมาชิก

คุณสมบัติบัญชีและสมาชิกจะกำหนดวิธีการจัดระเบียบบัญชีและวิธีการกำหนดบทบาทสำหรับการดำเนินการจัดการกล่องจดหมายที่ได้รับการป้องกัน ช่วยให้คุณควบคุมได้โดยตรงว่าใครบ้างที่สามารถใช้แต่ละบัญชีได้ และบัญชีใดที่ใช้งานสำหรับแต่ละคำขอได้

ทำไมเรื่องนี้ถึงสำคัญ

คุณสมบัตินี้จะกำหนดขอบเขตบัญชีสำหรับข้อมูลประจำตัว งาน งาน อีเมล และบันทึก ช่วยให้การสลับบัญชีชัดเจนและการกำหนดบทบาทในการเป็นสมาชิก ซึ่งช่วยลดข้อผิดพลาดเมื่อทีมทำงานในบัญชีหลักและบัญชีย่อย

คอร์โฟลว์

ขั้นแรกลูกค้าจะแสดงบัญชีที่สามารถเข้าถึงได้ เลือกบัญชีที่ใช้งาน และบันทึกตัวเลือกนั้นผ่านการสลับมุมมองบัญชี จากนั้นจะโหลดข้อมูลบัญชีและข้อมูลสมาชิก จากนั้นจึงทำการเปลี่ยนแปลงบัญชีหรือสมาชิกภายใต้บัญชีนั้น

การดำเนินงาน

การดำเนินงาน	จุดสิ้นสุด	วัตถุประสงค์
รายการบัญชี	GET /api/accounts	ดึงข้อมูลรายการบัญชีที่สามารถเข้าถึงได้
ค้นหาบัญชี	POST /api/accounts/search	ค้นหาบัญชีที่กำหนดโดยตัวกรอง
รับบัญชี	GET /api/accounts/:account_id	รับรายละเอียดบัญชี
สลับบัญชีที่ใช้งานอยู่	POST /api/account-views/switch	บันทึกการเลือกบัญชีที่ใช้งานอยู่
สร้างบัญชี	POST /api/accounts	สร้างบัญชีรูทหรือบัญชีลูก
อัพเดทบัญชี	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"
  }
}

โหมดความล้มเหลวและการควบคุม

คำขอสำหรับบัญชีที่อยู่นอกกลุ่มผู้โทรที่ตั้งไว้จะถูกปฏิเสธ และการเปลี่ยนแปลงสมาชิกจำเป็นต้องมีบทบาทที่ถูกต้อง การสลับบัญชีจะต้องกำหนดเป้าหมายบัญชีที่ผู้โทรสามารถเข้าถึงได้ และการเปลี่ยนแปลงวงจรชีวิตบัญชีจะเกิดขึ้นผ่านปลายทางบัญชีที่ชัดเจนเท่านั้น

ที่เกี่ยวข้อง

บัญชี, การเป็นสมาชิก, กระแสลูกค้าของผู้จัดการกล่องจดหมาย