服务端 API

加入群组后

在用户加入群组后同步成员变更。

触发时机

项目	说明
类型	后置回调
配置项	`afterJoinGroup`
回调命令	`callbackAfterJoinGroupCommand`

HTTP 请求

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

{
  "callbackCommand": "callbackAfterJoinGroupCommand",
  "operationID": "operation_001",
  "groupID": "group_001",
  "reqMessage": "申请说明",
  "joinSource": 1,
  "inviterUserID": "user_001"
}

请求体参数

参数名	是否必填	类型	说明
callbackCommand	是	string	回调命令，值与当前页面的回调命令一致。
operationID	是	string	OpenIM 操作的链路追踪 ID。
groupID	是	string	群组 ID。
reqMessage	是	string	入群申请或邀请说明。
joinSource	是	int	joinSource 字段。
inviterUserID	是	string	inviterUserID 字段。

响应

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

{
  "actionCode": 0,
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "nextCode": 0
}

响应参数

参数名	类型	说明
actionCode	int	处理状态，参见Webhooks 概述的 `CallbackAction`。
errCode	int	业务错误码；拒绝前置操作时返回业务约定的非零错误码。
errMsg	string	错误简要信息。
errDlt	string	错误详细信息。
nextCode	int	处理下一步，参见Webhooks 概述的 `CallbackNextCode`。

处理规则

事件发生后，OpenIM 异步调用该地址。
回调响应不能改变已经完成的 OpenIM 操作。
接收方应快速返回成功状态，再异步执行耗时业务。
接收方应按业务主键或 operationID 做幂等处理。

触发时机

HTTP 请求

请求体参数

响应

响应参数

处理规则

相关页面