#บัญชีและสมาชิก
คุณสมบัติบัญชีและสมาชิกจะกำหนดวิธีการจัดระเบียบบัญชีและวิธีการกำหนดบทบาทสำหรับการดำเนินการจัดการกล่องจดหมายที่ได้รับการป้องกัน ช่วยให้คุณควบคุมได้โดยตรงว่าใครบ้างที่สามารถใช้แต่ละบัญชีได้ และบัญชีใดที่ใช้งานสำหรับแต่ละคำขอได้
ทำไมเรื่องนี้ถึงสำคัญ
คุณสมบัตินี้จะกำหนดขอบเขตบัญชีสำหรับข้อมูลประจำตัว งาน งาน อีเมล และบันทึก ช่วยให้การสลับบัญชีชัดเจนและการกำหนดบทบาทในการเป็นสมาชิก ซึ่งช่วยลดข้อผิดพลาดเมื่อทีมทำงานในบัญชีหลักและบัญชีย่อย
คอร์โฟลว์
ขั้นแรกลูกค้าจะแสดงบัญชีที่สามารถเข้าถึงได้ เลือกบัญชีที่ใช้งาน และบันทึกตัวเลือกนั้นผ่านการสลับมุมมองบัญชี จากนั้นจะโหลดข้อมูลบัญชีและข้อมูลสมาชิก จากนั้นจึงทำการเปลี่ยนแปลงบัญชีหรือสมาชิกภายใต้บัญชีนั้น
การดำเนินงาน
| การดำเนินงาน | จุดสิ้นสุด | วัตถุประสงค์ |
|---|---|---|
| รายการบัญชี | 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"
}
}โหมดความล้มเหลวและการควบคุม
คำขอสำหรับบัญชีที่อยู่นอกกลุ่มผู้โทรที่ตั้งไว้จะถูกปฏิเสธ และการเปลี่ยนแปลงสมาชิกจำเป็นต้องมีบทบาทที่ถูกต้อง การสลับบัญชีจะต้องกำหนดเป้าหมายบัญชีที่ผู้โทรสามารถเข้าถึงได้ และการเปลี่ยนแปลงวงจรชีวิตบัญชีจะเกิดขึ้นผ่านปลายทางบัญชีที่ชัดเจนเท่านั้น