服务端 API
同意好友申请后
在好友关系建立后同步关系数据。
触发时机
| 项目 | 说明 |
|---|---|
| 类型 | 后置回调 |
| 配置项 | afterAddFriendAgree |
| 回调命令 | callbackAfterAddFriendAgreeCommand |
HTTP 请求
POST {WEBHOOK_ADDRESS}/callbackAfterAddFriendAgreeCommand
Content-Type: application/json
operationID: {OPERATION_ID}{
"callbackCommand": "callbackAfterAddFriendAgreeCommand",
"fromUserID": "user_001",
"blackUserID": "user_001",
"HandleResult": 1,
"HandleMsg": ""
}请求体参数
| 参数名 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| callbackCommand | 是 | string | 回调命令,值与当前页面的回调命令一致。 |
| fromUserID | 是 | string | 发起操作的用户 ID。 |
| blackUserID | 是 | string | 黑名单用户 ID。 |
| HandleResult | 是 | int | HandleResult 字段。 |
| HandleMsg | 是 | string | HandleMsg 字段。 |
响应
业务服务端应返回 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做幂等处理。
相关页面
这个页面有帮助吗?