列出角色下的成員 API

簡介

API 簡介

列出角色下的所有成員資訊。

API 版本

API 版本	更新時間	版本說明
V1	2023.10.11	1. 新增請求參數：是否包含分管部門資訊：has_manage_range 2. 新增回應參數：角色分管部門編號：departments_range；是否包含子部門：has_child。

API 調用

列出角色下的所有成員資訊。

附註：

只會返回邀請中和已激活的成員。

請求地址：https://api.jodoo.com/api/v5/corp/role/user/list

請求頻率：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	是	成員類型： 0: 常規成員
status	Number	是	成員狀態： 0: 未確認的成員 1: 已加入
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   }    ] }