跳到主要内容

获取会话共享配置​

GET /jim/converconfs/get?target_id=user_456&conver_type=1&sub_channel=

请求头见 接口说明。要求有效 legacy/ds1 用户身份,当前用户必须在 app 内存在。API Key 不允许;内部助手 svc 仅能以真实 subject 只读查询且仍校验会话权限,不允许 set。

参数必填说明
target_id是单聊对方 user_id 或群 group_id
conver_type是仅 1 单聊、2 群聊
sub_channel否默认空,各子频道独立保存

单聊双方共享配置,任一方可读写,目标用户须同 app 存在。群聊仅当前成员可读写;群主、管理员、普通成员均可修改,不限制角色,不新增群管理 mask 校验。

{"code":0,"msg":"success","data":{"msg_life_time":86400000,"forbid_forward":false,"content_protection":false,"watermark_enabled":false,"_config_meta":{"version":9,"event_id":"d5963ea7-3648-4c68-aa20-c672e48d8991"}}}

三个 bool 独立默认 false,未存储也会返回 false。msg_life_time 保留旧兼容:未存储则省略,旧非法或非正存储值读为 0;非负 int64,保留原值,服务端不转换菜单编码。原代码注释为毫秒,现有 iOS 同时兼容菜单编码,调用方应延续已有约定。

主要错误:17003 参数错误;17005 身份无效/用户不存在;17012 单聊目标不存在;17202 非群成员/群不存在;17000 数据库错误,不返回假成功默认值。

配置修改与通知、客户端内容保护/水印执行边界见 设置配置。

_config_meta 是新增保留字段,配置字段位置不变。version 是 DB scope 串行版本,event_id 是对应最新持久事件;未产生事件时为 {"version":0,"event_id":""}。GET 在一个 repeatable-read 只读事务中读取配置/元数据,不用消息 payload 作为权威版本。客户端应忽略未知保留字段,不能把 _config_meta 回传为 SET confs。

新事件和旧 type-only 消息均仅作 GET 刷新提示;普通客户端可伪造 event_id/version,没有服务端来源证明,不得按消息值压水位或过滤 GET。只有 GET 成功并通过 user/app/scope/session 校验,才持久化 GET 元数据并去重应用。GET 失败保留刷新任务、可取消退避重试,不写水位;账号切换清队列。生命周期缓存按 app/user/会话隔离,不读取归属未知的旧缓存。通知可靠性为至少一次,不保证 IM 恰好一次。非空子频道通知在尚不支持路由的客户端必须忽略,不得套用主会话。进入会话仍应主动 GET。