列出角色下的成员

列出角色下的所有成员信息。支持公共模式和集成模式。

注：只会返回邀请中和已激活的成员。

接口版本：

接口版本	更新时间	版本说明
v2	2022.4.8	初始版本：角色使用 role_no角色组使用 group_no包含 integrate_id、type 字段
v4	2022.6.30	返回值新增字段 status
v5	2022.10.28	在 v4 的基础上，接口请求频率由 5 次/秒提升至 30 次/秒；接口路由修改为 POST corp/role/user/list

请求地址：https://api.jiandaoyun.com/api/v5/corp/role/user/list

**请求频率：**30 次/秒

请求方式：POST

请求参数：

参数	位置	是否必需	说明
skip	Number	否	分页偏移
limit	Number	否	分页大小
role_no	Number	是	角色编号

请求示例：

{
    "skip": 0,
    "limit": 3,
    "role_no": 3
}

响应内容：

参数	类型	是否必须	说明
username	String	是	成员的编号，企业内唯一
name	String	是	成员昵称
departments	Number[]	是	成员所在部门编号列表
type	Number	是	成员类型：0: 常规成员2: 企业互联外部对接人
status	Number	是	成员状态：0: 未确认的成员1: 已加入
integrate_id	String	否	集成模式同步角色关联 ID，仅在集成模式下返回

返回示例：

{
  "users": [
    {
      "username": "aubrey",
      "name": "aubrey",
      "departments": [
        1
      ],
      "type": 0,
      "status": 1
    }
  ]
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

skip

number

分页偏移

可选

limit

number

分页大小

可选

role_no

number

角色编号

必需

示例

{
    "skip": 0,
    "limit": 0,
    "role_no": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

users

array [object {6}]

必需

username

string

可选

成员的编号，企业内唯一

name

string

成员昵称

可选

departments

array[number]

可选

成员所在部门编号列表

type

number

可选

成员类型： 0: 常规成员 2: 企业互联外部对接人

status

number

可选

成员状态： 0: 未确认的成员 1: 已加入

integrate_id

string

可选

集成模式同步角色关联 ID，仅在集成模式下返回

示例

{
    "users": [
        {
            "username": "aubrey",
            "name": "aubrey",
            "departments": [
                1
            ],
            "type": 0,
            "status": 1
        }
    ]
}

列出角色下的成员