跳到主要内容

同步群操作状态

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

开通服务​

  1. 信息托管服务已默认开通，您可以直接调用此接口。详情请参阅信息托管服务。

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

回调方法​

请求方法： POST

数据格式： application/json

融云 IM 服务端会在 HTTP 请求头（Header）中添加签名参数。您可以通过签名验证调用者身份和数据有效性。签名参数与验证方式请参阅服务端回调签名。

正文参数​

HTTP 请求正文数据格式为 application/json，支持以下参数：

参数类型必传说明
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。

HTTP
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 分钟后恢复。
最后于 更新