获取飞书应用机器人可见的群聊列表

使用已启用的 Feishu authenticator 配置获取 tenant_access_token，再调用飞书 im/v1/chats/search 接口查询当前机器人可见的群聊列表。
允许已登录用户调用。
如果系统存在多套飞书配置，可通过 authenticator 指定使用的认证器名称；不传时默认取第一套已启用且配置完整的 Feishu authenticator。当系统未配置任何可用的 Feishu authenticator 且未显式指定 authenticator 时，接口返回空结果而不是报错。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json

示例

{
    "authenticator": "feishu-main",
    "query": "销售",
    "pageSize": 20,
    "userIdType": "open_id"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

飞书原始群搜索结果

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "chat_id": "oc_a0553eda9014c201e6969b478895c230",
                "avatar": "https://p3-lark-file.byteimg.com/img/lark-avatar/default-avatar.jpg",
                "name": "测试群名称",
                "description": "测试群描述",
                "owner_id": "ou_xxx",
                "external": false,
                "tenant_key": "736588c9260f175e",
                "owner_id_type": "user_id",
                "chat_status": "normal"
            }
        ],
        "page_token": "dmJCRHhpd3JRbGV1VEVNRFFyTitRWDY5ZFkybmYrMEUwMUFYT0VMMWdENEtuYUhsNUxGMDIwemtvdE5ORjBNQQ==",
        "has_more": true,
        "db": "string",
        "properties": [
            {}
        ]
    }
}

🟠400

🟠403

🟠404