# 获取企业群活码数据统计

请求方式：POST

请求地址：https://$basehost/gateway/qopen/GetGroupActiveCodeStat

body参数：

{
  "begin_at": 1714579200,
  "end_at": 1715183999,
  "ac_id": "xxxxxx",
  "offset": 0,
  "limit": 35
}

字段	类型	必填	说明
offset	int	是	每次获取的的开始位置，最小值为0
limit	int	是	每次获取的条数，取值范围（1～100）
begin_at	int	是	开始时间戳
end_at	int	是	结束时间戳
ac_id	string	是	群活码id

返回值：

{
  "data": {
    "has_more": false,
    "list": [
      {
        "group_id": "群id",
        "group_name": "群名称",
        "incr_scan_num": 78,
        "incr_member_num": 36,
        "group_status": 4
      }
    ]
  },
  "errcode": 0,
  "errmsg": "",
  "hint": "xxx"
}

返回说明

字段	类型	说明
errcode	int	状态码，0为正常，非0代表错误
errmsg	string	错误信息
data	json	json返回值
list	arrays	群列表
name	string	群名称
group_id	string	群id
incr_scan_num	int	扫码人数
incr_member_num	int	进群人数
group_status	int	群状态 1：使用中：获取群二维码失败 3：超过设置群人数上限 4：取消关联群活码 5：群解散
has_more	bool	是否还有更多
hint	string	请求日志ID

完整请求示例：

curl -X POST \
  https://$basehost/gateway/qopen/GetGroupActiveCodeStat \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
      "begin_at": 1714579200,
      "end_at": 1715183999,
      "ac_id": "xxxxxx",
      "offset": 0,
      "limit": 35
}'

← 获取企业群活码列表机器人同意入群申请 →