列出角色下的成員 API - Jodoo

列出角色下的成員 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
  }
   ]
}