Chuyển tới nội dung chính

8. Đội & Tổ Chức

8.1 Liệt Kê Người Dùng​

GET /api/v1/users

Liệt kê người dùng tổ chức.

Tham Số Truy Vấn:

  • page - Số trang
  • limit - Mục mỗi trang
  • role - Lọc theo vai trò
  • department - Lọc theo phòng ban
  • status - Lọc: active, inactive

Phản hồi:

{
  "data": [
    {
      "id": "user-123",
      "email": "[email protected]",
      "fullName": "Nguyễn Văn A",
      "role": "admin",
      "department": "Bán Hàng",
      "phone": "+84.9.xxxx.xxxx",
      "avatar": "https://...",
      "status": "active",
      "createdAt": "2026-01-15T10:30:00Z",
      "lastLogin": "2026-06-05T14:22:00Z"
    }
  ],
  "pagination": { "total": 15, "page": 1, "limit": 50 }
}

8.2 Tạo Người Dùng​

POST /api/v1/users

Tạo thành viên đội mới.

Thân Yêu Cầu:

{
  "email": "[email protected]",
  "fullName": "Jane Smith",
  "role": "agent",
  "department": "Hỗ Trợ",
  "phone": "+84.9.yyyy.yyyy"
}

Phản hồi: 201

{
  "id": "user-126",
  "email": "[email protected]",
  "fullName": "Jane Smith",
  "role": "agent",
  "createdAt": "2026-06-05T17:35:00Z",
  "invitationSent": true
}

8.3 Cập Nhật Người Dùng​

PUT /api/v1/users/:id

Cập nhật thông tin người dùng.

Thân Yêu Cầu:

{
  "fullName": "Jane Smith",
  "role": "team_lead",
  "department": "Bán Hàng"
}

Phản hồi: 200

8.4 Xóa Người Dùng​

DELETE /api/v1/users/:id

Vô hiệu hóa người dùng.

Phản hồi: 204 Không Có Nội Dung

8.5 Liệt Kê Đội​

GET /api/v1/teams

Liệt kê các đội trong tổ chức.

Phản hồi:

[
  {
    "id": "team-001",
    "name": "Đội Bán Hàng",
    "description": "Đội bán hàng trực tiếp",
    "memberCount": 5,
    "createdAt": "2026-01-15T10:30:00Z"
  }
]

8.6 Tạo Đội​

POST /api/v1/teams

Tạo đội mới.

Thân Yêu Cầu:

{
  "name": "Bán Hàng Doanh Nghiệp",
  "description": "Đội bán hàng cho khách hàng doanh nghiệp",
  "memberIds": ["user-123", "user-124"]
}

Phản hồi: 201