get_group_at_all_remain

get_group_at_all_remain只读扩展
获取群 @全体成员 剩余次数

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

输入参数

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

返回 (data)

{ can_at_all, remain_at_all_count_for_group, remain_at_all_count_for_uin }:@全体可用性与剩余次数。

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

字段 类型 必填 说明
can_at_all boolean 当前是否可 @全体成员
remain_at_all_count_for_group integer 本群今日剩余 @全体次数
remain_at_all_count_for_uin integer 本账号今日剩余 @全体次数
原始 JSON Schema
{
  "type": "object",
  "properties": {
    "can_at_all": {
      "type": "boolean",
      "description": "当前是否可 @全体成员"
    },
    "remain_at_all_count_for_group": {
      "type": "integer",
      "description": "本群今日剩余 @全体次数"
    },
    "remain_at_all_count_for_uin": {
      "type": "integer",
      "description": "本账号今日剩余 @全体次数"
    }
  },
  "required": [
    "can_at_all",
    "remain_at_all_count_for_group",
    "remain_at_all_count_for_uin"
  ]
}

调用示例

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

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