跳到主要内容

托管信息审核结果回调

当托管资料触发审核时,融云可以将审核结果实时状态同步到您的应用服务器。

开通服务

调用此接口前,您须在控制台开通信息托管审核功能。

回调方法

请求方法: POST

数据格式application/json

即时通讯服务端会在 POST 请求 URL 中添加签名参数,您可通过签名验证调用者身份和数据有效性,详见服务端回调签名

正文参数

该回调服务的 HTTP 请求正文数据格式为 application/json,包含具有以下结构的 JSON 对象:

参数类型必传说明
eventTypeNumber1,群组资料审核;2,群成员资料审核;3,用户资料审核;4,好友资料审核
resultBoolean本次审核结果,true 为通过,false 为不通过。
timeLong审核时间
optUserIdString操作人
targetGroupIdString被操作群ID(群组相关审核时不为空)
targetUserIdString被操作人ID(好友资料和群成员资料审核时不为空)
contentsJsonArray审核内容详情
contents 结构
contents[i].keyString审核的字段 key
contents[i].contentString审核的内容
contents[i].resultBoolean本字段审核结果,true 为通过,false 为不通过。

回调代码示例

假设您在开通服务页面配置的回调接收地址为 http://example.com/group/info/profile/sync.php,示例代码如下:

HTTP
POST /user/profile/sync HTTP/1.1
Host: example.com
Content-Type: application/json


{
"eventType":2,
"result":false,
"time":1243444555552,
"optUserId":"optUserId1",
"targetGroupId":"groupId1",
"targetUserId":"targetGroupUserId1",
"contents": [
{
"key":"nickname",
"content":"XXXXX",
"result":true
},
{
"key":"extra",
"content":"XXXXX",
"result":false
}
]

}

响应回调请求

提示
  • 只要有 HTTP 200 OK 成功响应,服务端会认为状态已经同步。
  • 如果应答超时 5 秒,服务端会再尝试推送 2 次,如果仍然失败,将不再同步此条状态。
  • 如短时间内有大面积超时,将暂时停止请求您的服务器,1 分钟后会继续发送回调请求。异常断网情况下的会延迟 5 分钟同步。