跳到主要内容

同步托管资料变更状态

当应用用户资料发生变更时，您可以把实时用户资料同步到您的应用服务器上。

开通服务​

使用此功能前，您须在控制台开通信息托管服务，并且设置好服务器的回调地址。

回调方法​

请求方法： POST

数据格式： application/json

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

正文参数​

HTTP 请求正文数据格式为 application/x-www-form-urlencoded，支持以下 HTTP 表单参数：

参数类型必传说明
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",
    "time":1574476797772,
    "userProfile": {"uniqueId":"testAppName","level":2},
    "userExtProfile": {"ext_Profile":"testExt"}
}

响应回调请求​

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