功能说明
IM Server 存储群组信息,用于展示会话信息,当群组信息变更,需将变更后的信息调用此接口同步给 IM 服务。
群组信息同步时机
群组信息更新后 IM 服务 不会主动通知 至客户端,当前群组有新消息后会 IM 服务会自动将最新的群组信息同步至客户端
请求说明
请求鉴权:接口需要增加验证 Header,请查看 鉴权说明
请求类型:
POST
请求限频:
100次/秒
请求地址:https://请求域名/apigateway/groups/update
Content-Type:
application/json
请求参数
参数 | 数据类型 | 是否必填 | 参数说明 | |
---|---|---|---|---|
group_id | string | 是 | 需要更新的群id | |
group_name | string | 否 | 群昵称 | |
group_portrait | string | 否 | 群头像 | |
ext_fields | map | 否 | 扩展字段列表 |
请求示例
POST /apigateway/groups/update HTTP/1.1
appkey: appkey
signature: 2e639ae3600a4sdff61fb88b76f485b
nonce: nonce
timestamp: 1672568121910
Content-Type: application/json
{
"group_id":"group1",
"group_name":"group1",
"group_portrait":"xxx",
"ext_fields":{
"field1":"aaa",
"field2":"bbb"
}
}
响应示例
{
"code":0,
"msg":"sucess"
}