Nhân viên
Quản lý nhân viên, quyền module, phân tài khoản. · 13 endpoint
- GET/employees
- POST/employees
- GET/employees/online
- GET/employees/{employeeId}
- PATCH/employees/{employeeId}
- DELETE/employees/{employeeId}
- GET/employees/{employeeId}/permissions
- PUT/employees/{employeeId}/permissions
- GET/employees/{employeeId}/accounts
- PUT/employees/{employeeId}/accounts
- GET/employees/{employeeId}/sessions
- GET/employees/{employeeId}/stats
- POST/employees/{employeeId}/kick
Danh sách nhân viên
GET
/api/v1/employeesScope: employees:manageLệnh mẫu
bash
curl "http://127.0.0.1:9900/api/v1/employees" \
-H "Authorization: Bearer dpk_xxx"Tạo nhân viên
POST
/api/v1/employeesScope: employees:manageBody (JSON)
usernamebắt buộc | string max 50 | |
passwordbắt buộc | string max 200 | |
display_namebắt buộc | string max 100 | |
roletuỳ chọn | string max 30 · default "employee" |
Lệnh mẫu
bash
curl -X POST "http://127.0.0.1:9900/api/v1/employees" \
-H "Authorization: Bearer dpk_xxx" \
-H "Content-Type: application/json" \
-d '{"username":"string","password":"string","display_name":"string"}'Nhân viên đang kết nối
GET
/api/v1/employees/onlineScope: employees:manageLệnh mẫu
bash
curl "http://127.0.0.1:9900/api/v1/employees/online" \
-H "Authorization: Bearer dpk_xxx"Một nhân viên kèm quyền và tài khoản được giao
GET
/api/v1/employees/{employeeId}Scope: employees:manageTham số
employeeIdpath · bắt buộc | string max 200 |
Lệnh mẫu
bash
curl "http://127.0.0.1:9900/api/v1/employees/{employeeId}" \
-H "Authorization: Bearer dpk_xxx"Sửa nhân viên (tên, mật khẩu, bật/tắt)
PATCH
/api/v1/employees/{employeeId}Scope: employees:manageTham số
employeeIdpath · bắt buộc | string max 200 |
Body (JSON)
display_nametuỳ chọn | string max 100 | |
passwordtuỳ chọn | string max 200 | |
is_activetuỳ chọn | boolean | |
roletuỳ chọn | string max 30 |
Lệnh mẫu
bash
curl -X PATCH "http://127.0.0.1:9900/api/v1/employees/{employeeId}" \
-H "Authorization: Bearer dpk_xxx" \
-H "Content-Type: application/json" \
-d '{"display_name":"string","password":"string","is_active":false}'Xoá nhân viên
DELETE
/api/v1/employees/{employeeId}Scope: employees:manageTham số
employeeIdpath · bắt buộc | string max 200 |
Lệnh mẫu
bash
curl -X DELETE "http://127.0.0.1:9900/api/v1/employees/{employeeId}" \
-H "Authorization: Bearer dpk_xxx"Quyền module của nhân viên
GET
/api/v1/employees/{employeeId}/permissionsScope: employees:manageTham số
employeeIdpath · bắt buộc | string max 200 |
Lệnh mẫu
bash
curl "http://127.0.0.1:9900/api/v1/employees/{employeeId}/permissions" \
-H "Authorization: Bearer dpk_xxx"Đặt quyền module
PUT
/api/v1/employees/{employeeId}/permissionsScope: employees:manageTham số
employeeIdpath · bắt buộc | string max 200 |
Body (JSON)
permissionsbắt buộc | object | Module → true/false. Module: chat, friends, crm, workflow, integration, analytics, ai_assistant, settings, erp |
Lệnh mẫu
bash
curl -X PUT "http://127.0.0.1:9900/api/v1/employees/{employeeId}/permissions" \
-H "Authorization: Bearer dpk_xxx" \
-H "Content-Type: application/json" \
-d '{"permissions":{}}'Tài khoản được giao
GET
/api/v1/employees/{employeeId}/accountsScope: employees:manageTham số
employeeIdpath · bắt buộc | string max 200 |
Lệnh mẫu
bash
curl "http://127.0.0.1:9900/api/v1/employees/{employeeId}/accounts" \
-H "Authorization: Bearer dpk_xxx"Giao tài khoản cho nhân viên (ghi đè)
PUT
/api/v1/employees/{employeeId}/accountsScope: employees:manageTham số
employeeIdpath · bắt buộc | string max 200 |
Body (JSON)
account_idsbắt buộc | string[] max 500 items |
Lệnh mẫu
bash
curl -X PUT "http://127.0.0.1:9900/api/v1/employees/{employeeId}/accounts" \
-H "Authorization: Bearer dpk_xxx" \
-H "Content-Type: application/json" \
-d '{"account_ids":[]}'Phiên đăng nhập gần đây
GET
/api/v1/employees/{employeeId}/sessionsScope: employees:manageTham số
employeeIdpath · bắt buộc | string max 200 | |
limitquery · tuỳ chọn | integer ≥ 1 · ≤ 500 · default 50 |
Lệnh mẫu
bash
curl "http://127.0.0.1:9900/api/v1/employees/{employeeId}/sessions" \
-H "Authorization: Bearer dpk_xxx"Thống kê làm việc (tin đã xử lý, thời gian online...)
GET
/api/v1/employees/{employeeId}/statsScope: employees:manageTham số
employeeIdpath · bắt buộc | string max 200 | |
fromquery · tuỳ chọn | integer ≥ 0 | |
toquery · tuỳ chọn | integer ≥ 0 |
Lệnh mẫu
bash
curl "http://127.0.0.1:9900/api/v1/employees/{employeeId}/stats" \
-H "Authorization: Bearer dpk_xxx"Ngắt kết nối nhân viên đang online
POST
/api/v1/employees/{employeeId}/kickScope: employees:manageĐóng phiên đang mở (REST + realtime) và thu hồi token hiện tại: nhân viên phải đăng nhập lại. Vô hiệu hoá, xoá hoặc đổi mật khẩu nhân viên cũng thu hồi phiên ngay.
Tham số
employeeIdpath · bắt buộc | string max 200 |
Lệnh mẫu
bash
curl -X POST "http://127.0.0.1:9900/api/v1/employees/{employeeId}/kick" \
-H "Authorization: Bearer dpk_xxx"