get_group_shut_list

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

Call via POST http://127.0.0.1:3000/get_group_shut_list (JSON params as the body) or WebSocket.

Parameters

Param Type Required Default Description
group_id uint 群号

Returns (data)

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

Every response is wrapped in the standard envelope: { "status": "ok", "retcode": 0, "data": ... }. The table below describes data.

data is an array; each element:

Field Type Required Description
user_id integer 成员 QQ 号
nickname string 成员昵称
shut_up_time integer 禁言到期时间戳(秒)
Raw 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"
    ]
  }
}

Examples

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}'
Using an AI assistant?

MCP-capable clients can discover and call this action directly — no hand-written HTTP. See MCP.