人員職務管理

員工編號 姓名 登入帳號 所屬部門 擔任職務 操作
EMP-001 王大明 ming_wang 資訊部 部門經理
EMP-002 李小華 hua_li 客服部 專員
開發者 API 測試面板 (Mock Data)
1. 取得人員職務列表 [GET] /api/v1/users/roles
{
  "Success": true,
  "Data": {
    "totalCount": 45,
    "list": [
      { "UKey": "U001", "ID": "EMP-001", "Name": "王大明", "Account": "ming_wang", "DeptID": "D003", "DeptName": "資訊部", "UserRoleID": "R001", "RoleName": "部門經理", "Status": true }
    ]
  },
  "Message": "查詢成功"
}
2. 更新人員所屬部門與職務 [POST] /api/v1/users/{UKey}/role

Request Payload:

{
  "DeptID": "D003",
  "UserRoleID": "R008"
}
3. 新增人員 [POST] /api/v1/users

Request Payload:

{
  "Name": "張小華",
  "Account": "hua_zhang",
  "Password": "Init@2026",
  "Email": "hua@example.com",
  "Status": true,
  "DeptID": "D003",
  "UserRoleID": "R008"
}

Response:

{ "Success": true, "Data": { "UKey": "1024" }, "Message": "操作成功" }
4. 更新人員(全欄位) [POST] /api/v1/users/{UKey}

Request Payload(密碼留空 → 不變更):

{
  "Name": "張小華",
  "Account": "hua_zhang",
  "Password": "",
  "Email": "new_hua@example.com",
  "Status": true,
  "DeptID": "D003",
  "UserRoleID": "R008"
}