确认粉丝列表已读¶
请求参数¶
无路径或查询参数。身份只来自当前Bearer,管理员Cookie及客户端指定userId不能替代。要求ROLE_USER、当前账号可用、注册完成及当前会话渠道VIP准入。沿用八项公共头、安装/渠道/平台绑定、公共响应及AES/JWE。正式HTTPS/JWE与显式dev固定码HTTP明文兼容范围保持原协议;选择JWE仍要求可信HTTPS。
| 正文字段 | 类型 | 必填 | 规则 |
|---|---|---|---|
| readThrough | JSON整数(64位) | 是 | 0至本人当前lastSequence;取成功展示的无搜索粉丝首屏响应followerNotifications.lastSequence |
缺省、null、负数、字符串、浮点、布尔、越界及未知字段均400 BAD_REQUEST。客户端不能发送userId、未读数量、时间或对方身份。序号仅在当前认证账号内有意义;切换账号或重新登录须丢弃旧快照并重新读取列表。
请求示例¶
以下为合成快照,业务正文在统一层加密为本次REQUEST_JWE,不直接发送示意明文。完整公共头、Bearer及请求追踪由统一客户端动态提供。
{"readThrough": 12}
curl --request PUT "$API_ORIGIN/api/v1/me/relationships/followers/read" \
-H 'Accept-Language: zh-CN' \
-H 'X-Client-Type: app' -H 'X-Platform: android' \
-H 'X-App-Version: 1.0.0' -H 'X-App-Build: 1' -H 'X-Channel: xiaomi' \
-H "X-Device-Id: $INSTALLATION_UUID" \
-H "X-Request-Id: $REQUEST_UUID" -H "X-Request-Timestamp: $NOW_MILLIS" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Accept: application/jose' -H 'Content-Type: application/jose' \
-H 'X-Budyoo-Encryption: jwe-v1' --data-raw "$REQUEST_JWE"
成功响应¶
HTTP200,Cache-Control:no-store。下例为认证解密后的完整信封:列表展示时最新序号12,确认前又收到序号13,因此仍有一名未读。
{
"code": "SUCCESS",
"message": "操作成功。",
"data": {"unreadCount": 1, "lastSequence": 13, "readSequence": 12},
"errors": []
}
| 字段 | 类型 | 含义 |
|---|---|---|
| unreadCount | 非负整数 | 当前仍有效的粉丝关注边中,提示序号大于本人readSequence的数量;不是lastSequence与readSequence的差值 |
| lastSequence | 非负64位整数 | 本人累计成功新建关注的最新提示序号;取关不倒退,序号空缺不等于未读 |
| readSequence | 非负64位整数 | 所有设备共享的单向已读边界,始终不超过lastSequence |
旧边界或重复确认幂等,readSequence不倒退。超过本人lastSequence返回400且不写入。确认与关注共用目标账号锁,新关注晚于列表快照时,无论确认事务先后都保留新提示。返回提交后的最新快照;网络结果不明可以原readThrough重新确认,每次HTTP/JWE追踪信息须重新生成。
失败响应¶
| HTTP | code | 含义 |
|---|---|---|
| 400 | BAD_REQUEST/INVALID_CLIENT_HEADERS | 正文类型、缺失、未知字段、序号越界或公共头错误 |
| 401 | UNAUTHORIZED | 缺少/失效Bearer、旧会话、安装/渠道不匹配 |
| 403 | FORBIDDEN/VIP_REQUIRED/ACCOUNT_DISABLED/ACCOUNT_BANNED | 注册、会员、账号及运营限制,以原安全链实际码为准 |
| 426 | HTTPS_REQUIRED | 当前传输模式必须使用可信HTTPS |
| 503 | SERVICE_UNAVAILABLE | 数据库或必要依赖故障,不把失败当清零 |
message及字段错误支持中英日韩,缺省/未知回退英文,code固定。网关和加密错误按公共协议处理,不把无法认证的明文响应当成功。
接入说明¶
我的主页的summary.relationships与关系统计必有非空followerNotifications对象;无提示也返回三个真实0,不缺省或null。summary原准入分支为null时不额外暴露提示。旧服务没有该字段时表示能力未知,客户端保留兼容状态,不能据此确认或把未知伪装为已清零。
关系分页在kind=followers时于data下提供同一快照,其他kind明确为null。它在列表、总数及原所选资料的同一REPEATABLE_READ快照读取,未读统计不受q、页码或pageSize缩减。列表GET与主页GET均不写已读;“我的”左右切换、前台恢复只刷新原汇总。
用户成功打开并展示无搜索的粉丝首屏后,客户端才把该列表快照lastSequence送来确认。这表示“已打开截至该序号的粉丝列表”,并不保证逐个分页卡片阅读;搜索、加载更多、加载失败和未展示时不自动调用。气泡位于“我的”粉丝数字右上:正数显示+N,超过99显示99+,零隐藏;本次不增加底栏气泡或系统推送。
V44上线前已有关注关系的notification_sequence为0,均作为历史已读,不给旧粉丝突然制造气泡。实际新关注才递增;同一关系重复PUT不产生新增,取关删除这条未读,重新关注产生新序号。拉黑删除双向关注,解除不恢复;注销在原领域事务内清理本人提示及关系,失活/未完成粉丝不计入。状态保存在PostgreSQL,跨重启/多设备一致,不依赖Redis、客户端时间或本地总数差值。这不改变原新登录撤销旧会话的策略:新设备重新登录后读取同一账号状态,已撤销凭据仍401,不能继续确认已读。升级不改变旧五项计数或排序。旧程序兼容写入零序号,但不具备新增提示能力,回退后不能宣称该能力继续有效。
2026-11-11服务器完整clean verify共1234项,0失败、0错误、1项环境条件跳过(未启用DeepSeek真实供应商专项)。新增26项全部通过,覆盖MockMvc完整HTTP/JWE过滤器链、四语、身份及准入、强类型字段、多设备重新登录、取关重关、屏蔽、并发确认、事务回滚、双向注销和V43→V44历史基线;既有关系列表的精确字段断言同步验证新增对象与其他kind的null。所有正向关注、已读和注销验收仅在隔离数据库与合成账号中进行,不对运行账号制造关注或清除提示。
实现、部署服务器发布与客户端设备验收分别记录;以唯一项目进度的本任务状态为准。