查询群信息

开发环境

http://dev-cn.your-api-server.com

GET

/im/group/fans/list/

该接口用于查询自身为群主的粉丝群信息。

查询到群的 group_id 可用于 button组件加群能力

权限要求
小程序通过平台试运营期后默认获得的能力。注：关于小程序试运营期介绍详情请查看小程序试运营说明。
需要用户授权

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://dev-cn.your-api-server.com/im/group/fans/list/?open_id=123-456-890' \
--header 'Authorization: Bearer <token>'

响应示例

{
  "extra": {
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "now": 1648797449,
    "logid": "021648797449846fd1b1111000700600000000000000086dfb920",
    "error_code": 0
  },
  "data": {
    "error_code": 0,
    "description": ""
  },
  "group_list": [
    {
      "exist_num": 1,
      "group_name": "group_name",
      "max_num": 500,
      "description": "description",
      "entry_limit": null,
      "group_id": "@aaaaaa==",
      "status": "Normal",
      "tags": null,
      "avatar_uri": "avatar_uri"
    }
  ]
}

修改于 2025-11-07 09:30:46

用户加群webhook

设置进群问候语&群公告