get_group_shut_list

get_group_shut_list只读扩展
获取群禁言列表

通过 POST http://127.0.0.1:3000/get_group_shut_list(请求体为 JSON 参数)或 WebSocket 调用。

输入参数

参数 类型 必填 默认 说明
group_id uint 群号

返回 (data)

仍在禁言中的成员数组,每项含 QQ 号、昵称与禁言到期时间戳(秒)。

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

data 为数组,每个元素:

字段 类型 必填 说明
user_id integer 成员 QQ 号
nickname string 成员昵称
shut_up_time integer 禁言到期时间戳(秒)
原始 JSON Schema
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "user_id": {
        "type": "integer",
        "description": "成员 QQ 号"
      },
      "nickname": {
        "type": "string",
        "description": "成员昵称"
      },
      "shut_up_time": {
        "type": "integer",
        "description": "禁言到期时间戳(秒)"
      }
    },
    "required": [
      "user_id",
      "nickname",
      "shut_up_time"
    ]
  }
}

调用示例

curl
Python
JavaScript
Go
SnowLuma SDK
curl -X POST http://127.0.0.1:3000/get_group_shut_list \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"group_id":123456}'
在用 AI 助手?

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