同步托管资料变更状态

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

开通服务

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

回调方法

请求方法： POST

数据格式： application/json

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

正文参数

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

参数	类型	必传	说明
userId	String	是	用户 ID
type	int	是	变更类型： 0:清除 1:修改
time	Long	是	修改时间
userProfile	String	否	修改的用户基本信息，为 JSON 数据
userExtProfile	String	否	修改的用户扩展信息，为 JSON 数据

回调代码示例

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

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 分钟后会继续发送回调请求。异常断网情况下的会延迟 5 分钟同步。