获取用户或机器人所在的群列表

GET

/open-apis/im/v1/chats

获取用户或者机器人所在群列表。
注意事项：

查询参数user_id_type用于控制响应体中owner_id的类型

请注意区分本接口和获取群信息的请求URL。

查询参数 user_id_type 用于控制响应体中 owner_id 的类型，如果是获取机器人所在群列表该值可以不填。

错误码

HTTP状态码	错误码	描述	排查建议
400	232001	Your request contains an invalid request parameter.	参数错误，参考本文档检查输入参数。
400	232004	Such an app does NOT exist.	作为操作者的 app_id 不存在，请联系技术支持。
400	232025	Bot ability is not activated.	应用需要开启机器人能力。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://open.feishu.cn/open-apis/im/v1/chats' \
--header 'Authorization;'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "chat_id": "oc_a0553eda9014c201e6969b478895c230",
                "avatar": "https://p3-lark-file.byteimg.com/img/lark-avatar-staging/default-avatar_44ae0ca3-e140-494b-956f-78091e348435~100x100.jpg",
                "name": "测试群名称",
                "description": "测试群描述",
                "owner_id": "4d7a3c6g",
                "owner_id_type": "user_id",
                "external": false,
                "tenant_key": "736588c9260f175e"
            }
        ],
        "page_token": "dmJCRHhpd3JRbGV1VEVNRFFyTitRWDY5ZFkybmYrMEUwMUFYT0VMMWdENEtuYUhsNUxGMDIwemtvdE5ORjBNQQ==",
        "has_more": false
    }
}

请求参数

Query 参数

Header 参数

返回响应

🟢200成功

application/json

Body

修改于 2023-01-13 05:41:08

撤销群置顶

搜索对用户或机器人可见的群列表

获取用户或机器人所在的群列表

错误码#

请求参数

返回响应

错误码