同步群信息修改状态

当群组资料发生变更时，融云将实时把修改状态同步到您的应用服务器。

开通服务

1. 调用此接口前，您须在控制台开通信息托管服务。详情请参阅开启用户信息托管。

2. 设置群组资料变更的服务器回调地址。

   

回调方法

请求方法： POST

数据格式： application/json

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

正文参数

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

参数	类型	必传	说明
profiles	JsonArray	是	批量同步群信息变更
profiles 结构
profiles[i].groupId	String	是	群 ID
profiles[i].groupname	String	是	群 昵称
profiles[i].time	Long	是	修改时间
profiles[i].optUserId	String	否	操作的用户
profiles[i].groupProfile	JSON	否	群内置信息 , 为 JSON 数据，具体的key参考下方详情。
profiles[i].groupExtProfile	JSON	否	群扩展信息
profiles[i].permissions	JSON	否	群权限信息 , 为 JSON 数据，具体的key参考下方详情。

groupProfile 中的 key 如下：

key 值	类型	长度/取值范围	描述
introduction	String	长度不超过 512 个字符	群简介
announcement	String	长度不超过 1024 个字符	群公告
portraitUrl	String	长度不超过 128 个字符	群头像地址

permissions 中的 key 如下：

key 值	类型	长度/取值范围	描述
joinPerm	Number	取值范围： 0：需要群主验证（默认） 1：不用验证 2：群管理员或群主验证 3： 不允许任何人加入	加入群权限
removePerm	Number	取值范围： 0：群主（默认） 1：群主+群管理员 2： 所有人	将群成员移出群组权限
memInvitePerm	Number	取值范围： 0：群主（默认） 1：群主+群管理员 2： 所有人	邀请他人入群权限
invitePerm	Number	取值范围： 0：不需要被邀请人同意（默认） 1： 需要被邀请人同意	邀请加入群组处理方式
profilePerm	Number	取值范围： 0：群主（默认） 1：群主+群管理员 2： 所有人	修改群资料及权限
memProfilePerm	Number	取值范围： 0：群主+群管理员+自已（默认） 1：群主+自已 2： 仅自已	设置群成员资料权限

回调代码示例

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

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


[
    {
        "groupId":"groupId",
        "groupName":"groupName",
        "time":1574476797772,
        "optUserId":"userId",
        "groupProfile": {"introduction":"introduction","portraitUrl":"XXX"},
        "groupExtProfile": {"ext_Profile":"testExt"},
        "permissions": {"joinPerm":2,"memInvitePerm":1}
    },
    {
        "groupId":"groupId1",
        "groupName":"groupName1",
        "time":1574476797774,
        "optUserId":"userId1",
        "groupProfile": {"introduction":"introduction1","portraitUrl":"XXX1"},
        "groupExtProfile": {"ext_Profile":"testExt"},
        "permissions": {"joinPerm":1,"memInvitePerm":2}
    }
]

响应回调请求

提示

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