简体中文

get_group_admin_settings

get_group_admin_settings只读群管理

获取群管理设置的当前值

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

输入参数

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

返回 (data)

与对应设置接口字段对齐的当前群管理设置。

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

字段	类型	必填	说明
`add_type`	integer	✓	加群选项（同 set_group_add_option.add_type）
`group_question`	string	✓	加群问题（同 set_group_add_option.group_question）
`group_answer`	string	✓	加群答案（同 set_group_add_option.group_answer）
`robot_member_switch`	integer	✓	机器人加群开关（同 set_group_robot_add_option）
`robot_member_examine`	integer	✓	机器人加群审核（同 set_group_robot_add_option）
`member_invite_policy`	string (disabled / require_approval / no_approval / no_approval_under_100)	✓	成员邀请策略（同 set_group_member_invite_policy.policy）
`allow_member_upload_album`	boolean	✓	是否允许成员上传相册
`allow_member_temporary_session`	boolean	✓	是否允许成员发起临时会话
`allow_member_create_group`	boolean	✓	是否允许成员创建群聊
`new_member_history_visible`	boolean	✓	新成员是否可查看历史消息
`no_finger_open`	integer	✓	是否关闭群指纹/关键词搜索（0 开 1 关）
`no_code_finger_open`	integer	✓	是否关闭群号搜索（0 开 1 关）

原始 JSON Schema

{
  "type": "object",
  "properties": {
    "add_type": {
      "type": "integer",
      "description": "加群选项（同 set_group_add_option.add_type）"
    },
    "group_question": {
      "type": "string",
      "description": "加群问题（同 set_group_add_option.group_question）"
    },
    "group_answer": {
      "type": "string",
      "description": "加群答案（同 set_group_add_option.group_answer）"
    },
    "robot_member_switch": {
      "type": "integer",
      "description": "机器人加群开关（同 set_group_robot_add_option）"
    },
    "robot_member_examine": {
      "type": "integer",
      "description": "机器人加群审核（同 set_group_robot_add_option）"
    },
    "member_invite_policy": {
      "type": "string",
      "enum": [
        "disabled",
        "require_approval",
        "no_approval",
        "no_approval_under_100"
      ],
      "description": "成员邀请策略（同 set_group_member_invite_policy.policy）"
    },
    "allow_member_upload_album": {
      "type": "boolean",
      "description": "是否允许成员上传相册"
    },
    "allow_member_temporary_session": {
      "type": "boolean",
      "description": "是否允许成员发起临时会话"
    },
    "allow_member_create_group": {
      "type": "boolean",
      "description": "是否允许成员创建群聊"
    },
    "new_member_history_visible": {
      "type": "boolean",
      "description": "新成员是否可查看历史消息"
    },
    "no_finger_open": {
      "type": "integer",
      "description": "是否关闭群指纹/关键词搜索（0 开 1 关）"
    },
    "no_code_finger_open": {
      "type": "integer",
      "description": "是否关闭群号搜索（0 开 1 关）"
    }
  },
  "required": [
    "add_type",
    "group_question",
    "group_answer",
    "robot_member_switch",
    "robot_member_examine",
    "member_invite_policy",
    "allow_member_upload_album",
    "allow_member_temporary_session",
    "allow_member_create_group",
    "new_member_history_visible",
    "no_finger_open",
    "no_code_finger_open"
  ]
}

调用示例

curl

Python

JavaScript

SnowLuma SDK

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

在用 AI 助手？

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

ON THIS PAGE

get_group_admin_settings#

输入参数#

返回 (data)#

调用示例#

get_group_admin_settings

输入参数

返回 (data)

调用示例