查询群组列表分页

POST

http://manager.wecomapi.com/wecom/finder/api

接口提示

分页查询当前账号可见的群组列表。

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

请求成功时返回统一响应结构，具体字段以 data 内容为准。

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'http://manager.wecomapi.com/wecom/finder/api' \
--header 'WECOM-TOKEN: ' \
--header 'Content-Type: application/json' \
--data '{
  "method": "/room/getRoomList",
  "params": {
    "guid": "",
    "nextStartIndex": 0
  }
}'

响应示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "hasMore": false,
    "nextStartIndex": -1,
    "roomCount": 2,
    "roomList": [
      {
        "roomAvatarUrl": "https://wework.qpic.cn/****/0",
        "roomCreateTime": "1773381872",
        "roomUpdateTime": "1773382380",
        "roomId": "10813798765227242",
        "roomName": "test-update-txt",
        "roomOwnerId": "168885778221696",
        "roomMemberCount": 3,
        "roomFlag": 0,
        "ticket": "425126D7C8487E55****033AD9FC63968"
      },
      {
        "roomAvatarUrl": "https://wework.qpic.cn/w****17882/0",
        "roomCreateTime": "1773381862",
        "roomUpdateTime": "1773381862",
        "roomId": "1072151883628356",
        "roomName": "",
        "roomOwnerId": "168885778272696",
        "roomMemberCount": 3,
        "roomFlag": 0,
        "ticket": "F8F400190BF2FB1******C0060C69D7"
      }
    ]
  }
}

修改于 2026-07-03 10:03:16

企微文件下载

批量获取群详情