获取群成员列表

GET

/im/v1/chats/{chat_id}/members

获取用户/机器人所在群的群成员列表。

注意事项：

应用需要开启机器人能力

机器人或授权用户必须在群组中

该接口不会返回群内的机器人成员

由于返回的群成员列表会过滤掉机器人成员，因此返回的群成员个数可能会小于指定的page_size

如果有同一时间加入群的群成员，会一次性返回，这会导致返回的群成员个数可能会大于指定的page_size

获取内部群信息时，操作者须与群组在同一租户下

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Query 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://open.feishu.cn/open-apis/im/v1/chats/oc_a0553eda9014c201e6969b478895c230/members?member_id_type=open_id&page_token=dmJCRHhpd3JRbGV1VEVNRFFyTitRWDY5ZFkybmYrMEUwMUFYT0VMMWdENEtuYUhsNUxGMDIwemtvdE5ORjBNQQ==&page_size=10' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "member_id_type": "open_id",
                "member_id": "ou_9204a37300b3700d61effaa439f34295",
                "name": "张三"
            }
        ],
        "page_token": "0",
        "has_more": true
    }
}

修改于 2025-10-20 10:31:38

将用户或机器人移出群聊

判断用户或机器人是否在群里