跳到主要内容

同步群操作状态

当应用中发生对群组的操作的时候，包括创建群组、加入群组、踢出用户、用户退出、群组解散、添加管理员、移除管理员、转移群主这些群操作行为时，融云将操作状态实时同步到您的应用服务器。

开通服务​

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

  2. 设置群操作状态的服务器回调地址。

回调方法​

请求方法： POST

数据格式： application/json

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

正文参数​

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

参数类型必传说明
profilesJsonArray是需要同步的群信息变更
profiles 结构
profiles[i].groupIdString是群 ID
profiles[i].eventTypeNumber是操作类型：
  • 1：群组创建
  • 2：用户加入
  • 3：用户踢出
  • 4：用户退出
  • 5：群组解散
  • 6：加管理员
  • 7：减管理员
  • 8： 转让群组
profiles[i].timeLong是修改时间
profiles[i].optUserIdString否操作的用户
profiles[i].userIdsArray否被操作的用户

回调代码示例​

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

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


[
    {
        "groupId":"groupId",
        "eventType":7,
        "time":1574476797772,
        "optUserId":"userId",
        "userIds": ["userId1","userId2"]
    },
    {
         "groupId":"groupId1",
        "eventType":5,
        "time":1574476797772,
        "optUserId":["userId13","userId3"]
    }
]

响应回调请求​

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