2026-05-29-01 朋友圈设置(背景图)
1. 变更摘要
为朋友圈模块新增用户个人设置能力,当前落地第一个公开设置字段:背景图。
- 新增"修改朋友圈设置"接口,支持用户更新自己的背景图
- 新增"查看朋友圈设置"接口,支持查询任意用户的公开设置;查自己时可获取完整设置(含未来的私有字段)
- 设置以 upsert 方式持久化,底层集合为
moments_user_settings
2. 前端影响与动作
- 若需要展示"进入他人朋友圈"页面,建议在打开该页面时调用
GET /chatx/moments/settings/get,拿到bgURL后渲染背景图;未设置时bgURL为空字符串,前端自行降级处理。 - 若需要提供"修改我的朋友圈背景图"入口,调用
POST /chatx/moments/settings/update并传入bgURL。 - 两个接口均为新增,对既有动态相关接口无影响,前端可按需接入,动作等级:可不改。
3. 接口变更清单
3.1 新增接口
| 说明 | 路径 | 状态 | 链接 |
|---|---|---|---|
| 修改朋友圈设置 | /chatx/moments/settings/update | Active | 跳转 |
| 查看朋友圈设置 | /chatx/moments/settings/get | Active | 跳转 |
3.2 修改接口
无
3.3 删除接口
无
4. 兼容性说明
- 所有已有动态接口(发帖、删帖、动态流、点赞、评论等)请求结构与响应结构保持不变。
moments_user_settings为新增集合,不影响任何现有数据。- 首次查询未曾设置的用户时,返回
bgURL: "",不报错,前端无需特殊容错。
5. 前端对接步骤(最简)
- 进入他人朋友圈页面时,请求
POST /chatx/moments/settings/get(传targetUserID),用settings.bgURL渲染背景图,为空时显示默认背景。 - 我的朋友圈设置页,提供背景图上传/选择入口,确认后请求
POST /chatx/moments/settings/update(传bgURL)。