服务端 API

按字段设置群资料前

在按字段设置群资料前校验或调整本次变更。

触发时机

项目	说明
类型	前置回调
配置项	`beforeSetGroupInfoEx`
回调命令	`callbackBeforeSetGroupInfoExCommand`

HTTP 请求

POST {WEBHOOK_ADDRESS}/callbackBeforeSetGroupInfoExCommand
Content-Type: application/json
operationID: {OPERATION_ID}

{
  "callbackCommand": "callbackBeforeSetGroupInfoExCommand",
  "operationID": "operation_001",
  "groupID": "group_001",
  "groupName": "group_001",
  "notification": "",
  "introduction": "",
  "faceURL": "https://example.com/avatar.png",
  "ex": "",
  "needVerification": 1,
  "lookMemberInfo": 1,
  "applyMemberFriend": 1
}

请求体参数

参数名	是否必填	类型	说明
callbackCommand	是	object	回调命令，值与当前页面的回调命令一致。
operationID	是	string	OpenIM 操作的链路追踪 ID。
groupID	是	string	群组 ID。
groupName	否	string	群组名称。
notification	否	string	群公告。
introduction	否	string	群简介。
faceURL	否	string	头像地址。
ex	否	string	业务扩展字段。
needVerification	否	int	入群验证方式。
lookMemberInfo	否	int	是否允许普通成员查看群成员资料。
applyMemberFriend	否	int	是否允许普通成员添加群成员为好友。

响应

业务服务端应返回 HTTP 成功状态和 JSON 响应体。

{
  "actionCode": 0,
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "nextCode": 0,
  "groupID": "group_001",
  "groupName": "group_001",
  "notification": "",
  "introduction": "",
  "faceURL": "https://example.com/avatar.png",
  "ex": "",
  "needVerification": 1,
  "lookMemberInfo": 1,
  "applyMemberFriend": 1
}

响应参数

参数名	类型	说明
actionCode	int	处理状态，参见Webhooks 概述的 `CallbackAction`。
errCode	int	业务错误码；拒绝前置操作时返回业务约定的非零错误码。
errMsg	string	错误简要信息。
errDlt	string	错误详细信息。
nextCode	int	处理下一步，参见Webhooks 概述的 `CallbackNextCode`。
groupID	string	群组 ID。
groupName	string	群组名称。
notification	string	群公告。
introduction	string	群简介。
faceURL	string	头像地址。
ex	string	业务扩展字段。
needVerification	int	入群验证方式。
lookMemberInfo	int	是否允许普通成员查看群成员资料。
applyMemberFriend	int	是否允许普通成员添加群成员为好友。

处理规则

OpenIM 同步等待业务服务端响应。
返回 nextCode: 0 时继续原流程；返回 nextCode: 1 时，OpenIM 使用响应中的错误信息终止本次操作。
请求失败或超时后的行为由该回调的 failedContinue 配置决定。
响应中的业务字段仅在对应字段存在时覆盖 OpenIM 即将处理的数据。

触发时机

HTTP 请求

请求体参数

响应

响应参数

处理规则

相关页面