批量按 open_id 查询用户

一次查询最多 100 个 open_id，返回用户完整信息（结构同列表接口），按请求顺序返回。

需要 WS_USER VIEW 权限。

查不到 / 不属于当前 workspace 的 open_id 静默省略，不报错；调用方用「请求集合 - 返回集合」推导缺失项。

重复 open_id 自动去重。

ws_group_list 含用户所属角色，可直接用于「用户→角色」反向查询（传单个 open_id 即可）。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

{
    "open_ids": [
        "ou_xxx",
        "ou_yyy",
        "ou_unknown"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

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

4006 workspace_not_found

4084 invalid_open_api_user_id

注意：部分 open_id 查不到不会返 4xxx，只是不在返回数组里。

Bodyapplication/json

示例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "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