简体中文

get_group_info

get_group_info只读群信息

获取群信息

通过 POST http://127.0.0.1:3000/get_group_info（请求体为 JSON 参数）或 WebSocket 调用。

输入参数

参数	类型	必填	默认	说明
`group_id`	uint	✓		群号
`no_cache`	bool	–	`false`

返回 (data)

群信息对象。

所有响应都包裹在标准信封中：{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。

字段	类型	必填	说明
`group_id`	integer	✓	群号
`group_name`	string	✓	群名
`member_count`	integer	✓	当前成员数
`max_member_count`	integer	✓	成员上限
`group_create_time`	integer	–	建群时间戳（秒）
`group_level`	integer	–	群等级
`group_memo`	string	–	群简介 / 公告预览

原始 JSON Schema

{
  "type": "object",
  "properties": {
    "group_id": {
      "type": "integer",
      "description": "群号"
    },
    "group_name": {
      "type": "string",
      "description": "群名"
    },
    "member_count": {
      "type": "integer",
      "description": "当前成员数"
    },
    "max_member_count": {
      "type": "integer",
      "description": "成员上限"
    },
    "group_create_time": {
      "type": "integer",
      "description": "建群时间戳（秒）"
    },
    "group_level": {
      "type": "integer",
      "description": "群等级"
    },
    "group_memo": {
      "type": "string",
      "description": "群简介 / 公告预览"
    }
  },
  "required": [
    "group_id",
    "group_name",
    "member_count",
    "max_member_count"
  ]
}

调用示例

curl

Python

JavaScript

SnowLuma SDK

curl -X POST http://127.0.0.1:3000/get_group_info \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"group_id":123456,"no_cache":false}'

在用 AI 助手？

支持 MCP 的客户端可直接发现并调用本动作，无需手写 HTTP。见 MCP 接入。

ON THIS PAGE

get_group_info#

输入参数#

返回 (data)#

调用示例#

get_group_info

输入参数

返回 (data)

调用示例