簡介
API 簡介
列出角色下的所有成員資訊。
API 版本
API 版本 | 更新時間 | 版本說明 |
V1 | 2023.10.11 | 1. 新增請求參數： 是否包含分管部門資訊：has_manage_range 2. 新增回應參數： 角色分管部門編號：departments_range； 是否包含子部門：has_child。 |
API 調用
列出角色下的所有成員資訊。
附註：
只會返回邀請中和已激活的成員。
請求頻率：30 次/秒
請求方式：POST
請求參數：
參數 | 位置 | 是否必需 | 說明 |
skip | Number | 否 | 分頁偏移 |
limit | Number | 否 | 分頁大小 |
role_no | Number | 是 | 角色編號 |
has_manage_range | Boolean | 否 | 是否包含分管部門資訊，預設值為 false。 |
請求範例：
{ "skip": 0, "limit": 3, "role_no": 72, "has_manage_range": True }回應內容：
參數 | 類型 | 是否必須 | 說明 |
username | String | 是 | 成員的編號，企業內唯一 |
name | String | 是 | 成員暱稱 |
departments | Number[] | 是 | 成員所在部門編號列表 |
type | Number | 是 | 成員類型：
|
status | Number | 是 | 成員狀態：
|
departments_range | Number[] | 否 | 角色分管部門編號 附註：只有配置了分管部門的成員纔會顯示此參數。 |
has_child | Boolean | 否 | 是否包含子部門 附註：只有配置了分管部門的成員纔會顯示此參數。 |
返回範例：
{ "users": [ { "username": "jodoo-xulalikdbj82", "name": "frank", "departments": [212], "type": 0, "status": 1, "deptarments_range": [378,1157], "has_child": true }, { "username": "R-E9rRNbwL", "name": "成員刪除1", "departments": [338,226], "type": 0, "status": 1, "deptarments_range": [1157], "has_child": false }, { "username": "UPDATE", "name": "testadmin", "departments": [1], "type": 0, "status": 1 } ] }