跳到主要内容

托管资料变更回调

当应用用户资料发生变更时，融云 IM 服务端会将变更后的用户资料实时回调至您的应用服务器。

开通服务​

信息托管服务已默认开通，您需要设置好服务器的回调地址即可使用此功能。

请先按控制台内嵌指南将 IM 服务功能配置页面（page_code: im_service_config）嵌入到自己的管理后台；完成后，在自己的管理后台中进入 用户 > 用户资料变更回调，设置回调地址并启用该功能。

回调方法​

请求方法： POST

数据格式： application/json

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

正文参数​

HTTP 请求正文是一个 JSON 数组，数组中的每个元素表示一条变更记录，包含以下字段：

参数类型必传说明
userIdString是用户 ID
typeInt是变更类型：
0：清除
1：修改
timeLong是修改时间
userProfileString否修改的用户基本信息，为 JSON 字符串
userExtProfileString否修改的用户扩展信息，为 JSON 字符串

回调代码示例​

以下示例假设您在开通服务页面配置的回调接收地址为 http://example.com/user/profile/sync.php。

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


[
    {
        "userId":"uid1",
        "type":1,
        "time":1574476797772,
        "userProfile": "{\"uniqueId\":\"testAppName\",\"level\":2}",
        "userExtProfile": "{\"ext_Profile\":\"testExt\"}"
    }
]

响应回调请求​

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