# 获取企业群活码关联的群列表

请求方式:POST

请求地址:https://$basehost/gateway/qopen/GetGroupActiveCodeGroupList

body参数

{
  "ac_id": "groupxxxxxx",
  "offset": 0,
  "limit": 35
}
字段 类型 必填 说明
offset int 每次获取的的开始位置,最小值为0
limit int 每次获取的条数,取值范围(1~100)
ac_id string 群活码id

返回值:

{
    "data": {
        "list": [
            {
                "group_id": "groupcMIBKfmpjtP1UvQVAU73",
                "is_deleted": false,
                "is_watch": false,
                "group_status": 1,
                "group_type": 1
            },
            {
                "group_id": "groupNdcXRMs63xVW7fSX8a1O",
                "is_deleted": false,
                "is_watch": false,
                "group_status": 1,
                "group_type": 1
            }
        ],
        "has_more": false
    },
    "errcode": 0,
    "errmsg": "",
    "hint": "IYqLFTwBrxiKjx2nqaEA"
}

返回说明

字段 类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
data json json返回值
list arrays 群列表
group_id string 群id
is_deleted bool true:已失效 false:未失效
is_watch int 是否开通关注 true 已开通 false 未开通
group_status int 群状态 1:使用中 :获取群二维码失败 3:超过设置群人数上限 4:取消关联群活码 5:群解散
group_type int 群状态 1:手动选择 2:自动创建

完整请求示例:

curl -X POST \
  https://$basehost/gateway/qopen/GetGroupActiveCodeGroupList\
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
    "ac_id" : "groupactcodeodqpdghMDJACuzzTK1EE",
    "offset" : 0,
    "limit" : 10
}'
最后更新时间: 2026/1/14 17:55:07