服务端 API

发起好友申请前

在发起好友申请前执行权限或风控校验。

触发时机

项目	说明
类型	前置回调
配置项	`beforeAddFriend`
回调命令	`callbackBeforeAddFriendCommand`

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

{
  "callbackCommand": "callbackBeforeAddFriendCommand",
  "fromUserID": "user_001",
  "toUserID": "user_001",
  "reqMsg": "申请说明",
  "ex": ""
}

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

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

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