Skip to main content

功能说明

IM Server 存储用户信息,用于展示消息发送信息或会话信息,当用户信息变更,需将变更后的信息调用此接口同步给 IM 服务。

用户信息同步时机

用户信息更新后 IM 服务 不会主动通知 至客户端,与当前用户有关的会话产生消息后会 IM 服务会自动将最新的用户信息同步至客户端

请求说明

请求鉴权:接口需要增加验证 Header,请查看 鉴权说明

请求类型POST

请求限频100次/秒

请求地址:https://请求域名/apigateway/users/update

Content-Typeapplication/json

请求参数

参数数据类型是否必填参数说明
user_idstring需要更新的用户id
nicknamestring昵称
user_portraitstring头像
ext_fieldsmap扩展字段列表

请求示例

POST /apigateway/users/update HTTP/1.1
appkey: appkey
signature: 2e639ae3600a4sdff61fb88b76f485b
nonce: nonce
timestamp: 1672568121910
Content-Type: application/json

{
"user_id":"userid1",
"nickname":"user1",
"user_portrait":"xxxxx",
"ext_fields":{
"field1":"aaa",
"field2":"bbb"
}
}

响应示例

{
"code":0,
"msg":"sucess"
}