设置群设置

1. 接口定位

• 接口名称: 设置群设置
• 所属域: admin/group
• 业务目标: 写入群组 settings 中的进群开关

2. 请求定义

• Method: POST
• Path: /adminx/group/settings/set
• Content-Type: 推荐 application/json
• operationID: 必填，请通过 Header operationID 传入
• 鉴权: 需要 Header token，且必须是管理员 token
• 幂等性: 幂等（相同参数可重复提交）

3. 请求参数

Header 参数

字段	必填	类型	说明
operationID	是	string	链路追踪 ID
token	是	string	管理员 token

Body 参数

字段	必填	类型	说明
groupID	是	string	群组 ID
joinDisabled	是	bool	是否禁止进群，true 为禁止

4. 响应结构

通用响应包裹

字段	类型	说明
errCode	int	错误码，0 表示成功
errMsg	string	错误简述
errDlt	string	错误详情
data	object	业务数据

data 字段

字段	类型	说明
groupID	string	群组 ID
joinDisabled	bool	当前写入结果

5. 业务规则

• group_settings 按 groupID 唯一 upsert。
• 每次写入都会覆盖 joinDisabled 并记录最近操作人和更新时间。

6. 错误码与失败场景

错误码	场景	典型报错
1001	Header 缺少 operationID	header must have operationID
1001	groupID 为空	groupID is empty
-	缺少管理员 token	由管理员鉴权链路返回

7. 示例

fetch 请求示例

fetch("http://localhost:10011/adminx/group/settings/set", {
  method: "POST",
  headers: {
    operationID: "group-settings-set-001",
    token: "eyJhbGciOi...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    groupID: "group_001",
    joinDisabled: true,
  }),
})
  .then((res) => res.json())
  .then((data) => console.log(data));

成功响应示例

{
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "data": {
    "groupID": "group_001",
    "joinDisabled": true
  }
}

8. 变更记录

• 2026-07-28: 新增群设置写入接口文档。