查询角色成员列表

分页返回角色下的成员。

需要 WS_USER VIEW 权限。

成员项是用户标准字段子集（open_id / ws_username / ws_user_type / is_active / email / mobile_num / avatar_url），不含 ws_group_list。

只按 ws_group_id 查询；如只有角色名，先用 GET /ws-groups?keyword= 解析出 id（角色名可改名，id 稳定）。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

成功（code=200）或业务错误。可能错误码：

4031 ws_group_not_found（角色不存在或不属于当前 workspace）

4084 invalid_open_api_user_id

Bodyapplication/json

示例

{
    "code": 200,
    "message": "success",
    "data": {
        "total": 1,
        "page_size": 20,
        "current_page": 1,
        "total_pages": 1,
        "results": [
            {
                "open_id": "ou_xxx",
                "ws_username": "张三",
                "ws_user_type": 1,
                "is_active": true,
                "email": "zhangsan@example.com",
                "mobile_num": "13800000001",
                "avatar_url": "https://cdn.emooai.com/avatar/u1.png?X-Amz-Signature=xxx"
            }
        ]
    }
}

🟠400

🟠401

请求参数

请求示例代码

返回响应