公共对象 | 泡泡 IM 开发文档

本页集中说明 HTTP 与实时事件共用的对象。对象中的完整字段应原样保留，null 不应替换成缺失字段。示例身份为陈悦与林舟，时间仅用于展示结构。
系统通知使用独立对象：SystemNotificationInbox 收件箱、SystemNotification 卡片与SystemNotificationPage 分页。HTTP 和 system_notifications.updated 共用同一字段结构，不属于 Conversation 或 Message。
公开用户资料不包含密码、手机号或宿主登录态。
Presence 为 { "online": true, "online_updated_at": 1792301400000 }，也可为 null。在线状态是读取时快照，与公开资料版本独立；不能仅凭资料更新时间判断在线新旧。
群聊使用 type="group"，target_id=group_id，包含完整 group，group_role 为 owner / admin / member，member_count 为整数。单聊含完整 peer 与可空 peer_presence；群聊的 peer_read_seq、peer_presence 为 null。
共享群消息事件的 read_seq、unread_count、pinned、muted、state、group_role、send_forbidden_until、announcement_unread、mention_unread 可为 null，客户端保留既有私有值并依据消息归约。
撤回与删除后内容字段为 null；删除 tombstone 保留原 mid 和 conversation_seq 供时间线消费序号，界面不再渲染该气泡。不要将缺少正文的消息当成序号缺口。
status 为 active / disabled / dissolved；unread_mode 为 fanout / sequence。后者由服务端管理，不是客户端可设置选项。群公开资料与当前账号的 Membership 分开更新。
membership.status 还可能为 left / removed / dissolved，此时会话隐藏、权限关闭。role 为 owner / admin / member。界面直接使用 permissions 判断操作，不要仅根据角色猜测；群禁用、全员禁言和个人禁言都会影响权限。
presence 可空，成员排序与分页由服务端提供。
relation.status 为 friend / stranger；conversation_settings 为当前账号私有设置；permissions 是当前可用操作。修改关系的响应另含可空 event_id。