获取工作区用户列表

分页返回当前工作区下的用户列表，支持关键词搜索。

需要 WS_USER VIEW 权限。

ws_username 缺失时按 display_name / username / mobile_num 顺序回退。

ws_group_list / email / mobile_num / ext_info 可能为 null。

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）或业务错误。可能错误码：

4006 workspace_not_found（workspace 不存在或被删除）

4084 invalid_open_api_user_id

Bodyapplication/json

示例

{
    "code": 200,
    "message": "success",
    "data": {
        "total": 50,
        "page_size": 50,
        "current_page": 1,
        "total_pages": 1,
        "results": [
            {
                "open_id": "ou_xxx",
                "user_id": 1,
                "is_active": true,
                "workspace_id": 1,
                "ws_user_type": 1,
                "ws_username": "张三",
                "created_at": "2026-01-01T00:00:00Z",
                "updated_at": "2026-01-02T00:00:00Z",
                "ws_group_list": [
                    {
                        "id": 1,
                        "group_name": "技术部",
                        "workspace_id": 1
                    }
                ],
                "email": "zhangsan@example.com",
                "mobile_num": "13800000001",
                "avatar_url": "https://cdn.emooai.com/avatar/u1.png?X-Amz-Signature=xxx",
                "ext_info": null
            }
        ]
    }
}

🟠400

🟠401

请求参数

请求示例代码

返回响应