人員職務管理
| 員工編號 | 姓名 | 登入帳號 | 所屬部門 | 擔任職務 | 操作 |
|---|---|---|---|---|---|
| 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"
}