我的与设置接入¶
本页按当前UI划分实际能力。接口存在、服务器部署、Flutter接入和外部供应商接通分别验收;不能把设计数据当成真实账号数据。
「我的」首屏使用GET /api/v1/me/home一次读取资料与渠道VIP、所选国家/语言四语名称、关系、钱包、动态/点赞总数,以及最近动态和最多三位最近访客的头像索引。访客卡片读取summary.recentVisitors中的userId、avatarUrl及该访客当前有效权益vipActive,总人数取summary.relationships.visitors;访客会员由服务端一次批量读取,失败整份主页503,不借用当前查看者或渠道开关;首屏不额外调用关系列表或逐人公开资料。刷新和返回同样更新这一份快照,不再用七个JSON请求拼接首屏。头像与国旗按返回编号/路径单独走原媒体及缓存;完整目录、编辑与列表仅在进入对应二级页后按需读取。旧接口保留兼容,不能因为汇总可读而绕过注册、VIP或封禁。
| 页面或功能 | 使用方式与范围 |
|---|---|
| 本人资料、头像、昵称、简介、语言、兴趣 | 首屏home.account/display;GET /me/profile一次读资料及所选名称/图标,PATCH直接回新display;打开选择器才取完整目录,头像上传后保存绑定 |
| 相册 | 现有暂存上传、鉴权读取、丢弃及资料统一保存;最多9张、介绍30个UTF-16代码单元、性别只读 |
| Budyoo ID与账号安全 | GET /me/account返回真实数字publicId和脱敏绑定,不再显示80260918等设计ID |
| 换绑手机号/邮箱 | 旧绑定挑战→验证取得CHANGE_ACCOUNT证明→新地址挑战→PUT binding;成功撤销全部会话,重新登录 |
| 注销 | GET deletion查看未结条件→旧绑定验证DELETE_ACCOUNT→POST deletion;立即或7天;等待期重新验证登录自动取消 |
| 通知偏好 | GET/PATCH settings/notifications;账号级持久化+并发版本,系统通知权限和真实推送独立 |
| 好友/关注/粉丝/访客/黑名单 | relationships分页与counts,关注/取消及屏蔽/解除接口;好友为互相关注,浏览公开主页记录访客 |
| 钱包/收支 | GET wallet与wallet/entries读取真实余额和流水;wallet/recharge读取平台国家套餐,充值入口始终保留。rechargeAvailable=false只保留旧支付能力语义,不生成模拟到账 |
| 应用语言 | 本机LocaleManager与持久偏好,不需要新增服务端写接口 |
| 缓存清理 | 本机清理已明确支持的缓存,不删除服务器相册、聊天记录或凭据 |
| 协议 | GET /agreements?layoutPolicy=ip-v1,新客户端按后端IP布局选择国内4中文/国际四语配置;旧无参数调用保留渠道兼容;不可用不伪造正文 |
| 关于/检查更新 | 包版本来自实际安装包,升级复用GET /app/updates,不能显示静态1.4.0 |
| 退出登录 | 现有POST /auth/logout或logout-all;停止注册只本地清理,不调用退出接口 |
| 我的动态/点赞与发布 | 本人动态及点赞分页、文本/最多9图发布、详情、点赞/取消和本人删除;独立图片暂存,不直接公开私有相册。完整互动发现、音视频、评论和人工审核的新契约见互动与审核,发布后先待审;不包含自动内容审核 |
粉丝新增提示随原主页summary.relationships与关系统计返回followerNotifications,并随粉丝列表返回同一快照。普通切栏不清零,成功打开无搜索首屏后才明确确认已读;旧快照不会清除之后新增,不依赖客户端时间、总数差值或长连接。
账号安全细节¶
手机号或邮箱从服务端已绑定身份中选择,不根据国内/国际或设备语言猜登录类型。纯三方账号没有可验证手机号/邮箱时返回canVerifyAccount=false,不能拿固定123456代替验证第三方身份;相关绑定能力需完成实际三方流程后提供。
所有敏感证明绑定本人、当前session、用途、旧地址和到期时间。登录验证码、另一设备登录会话的证明、换绑证明不能拿来注销。正常访问Token刷新不改变session,可继续同一流程。离开、退出或换号清除临时proofToken和验证码,不持久化到普通偏好或日志。
注销成功后清本机会话。七天计划保存在数据库,后台重启不丢;到期由任务处理,未结余额或有效VIP先阻止自动注销,不自动放弃用户资产。注销会清除活跃身份、个人资料、关系与反馈,媒体通过持久队列删除;备份和必须保留的历史交易不宣称即时擦除。真实退款和支付处理尚未上线,阻碍事项不能由客户端paid=false解除。
关联和媒体¶
关系列表每项顶层vipActive为本条profile.userId的实际有效会员,五类kind均为非空boolean;一页批量读取,空页不补查,会员故障整页503,不借用查看者或渠道状态。关系列表首屏、下拉刷新与上拉加载统一使用GET /api/v1/me/relationships,仅改变page;默认page=1、pageSize=20,响应统一为items、total、page、pageSize、hasMore。每项保留公开资料及头像地址,并增加所选国家/国旗、我会的语言及学习语言的四语display,客户端不再读取完整国家/语言目录或逐人资料。按关系时间与唯一UUID倒序,分页及计数同快照,失败返回正常错误。屏蔽会解除双向关注,解除屏蔽不自动恢复;后续聊天发送必须复用SocialAccess,不以页面隐藏替代服务器授权。当前WebSocket只有连接基础,不能宣称已完成聊天业务或即时客服。
用户详情使用主页聚合一次读取已审资料、目标VIP、所选国家/语言/兴趣四语名称和图标、详情专用生日/服务端年龄及可见性、真实长连接租约状态、三项目标关系数字、有序已审相册和操作能力;动态继续独立分页,不拉完整目录。其他列表的最小profile仍不含生日,手机号邮箱及私有候选相册始终不公开。三项统计只展示,聊天尚无真实会话入口,canChat=false/NOT_IMPLEMENTED;依赖故障整份503,不伪造普通VIP、0、空相册或离线。用户当前头像走统一鉴权媒体入口,本人读最新已保存绑定图,其他人只读已审公开图,无对应引用才返回服务端默认图;公开相册走逐次鉴权照片入口,自看也仅已审公开引用。未绑定的暂存上传不生效;任一方向屏蔽仍无法读取完整资料及媒体,本人方向仅开放下面的受限身份快照。
当前外部依赖¶
当前dev短信/邮箱仍为固定123456隔离身份,真实供应商未配置;prod不会开启固定码或HTTP例外。平台国家套餐及展示价格现由后台充值配置维护;微信/支付宝/Google Play/Apple的真实支付、商品绑定、验签、退款及VIP发放仍需供应商配置与独立业务实现,套餐可见不代表支付已接入。动态、评论、音视频和举报审核的实际能力见互动接口,发布先待审;推荐算法、送礼及完整实时聊天仍未接通,不用演示内容替代。
账号安全、通知、关系、钱包和动态按本页列出的独立契约接入。帮助与反馈的提交、记录、详情及后台收发接口已于2026-11-06移除,相关旧页面入口同步删除。客服从消息页既有入口进入,实际服务接通范围以消息业务为准。
用户详情支持昵称页头及真实菜单:主体新增identity、viewState与blockedByMe,capabilities增加canUnblock/canReport,本人面向他人操作全部禁用。我方屏蔽只返回最小已审昵称身份与解除/举报能力,完整资料、VIP、生日、租约、数字与相册为null且不记访客;对方单独屏蔽及不可用目标统一404,媒体与动态仍按双向屏蔽。PUT/DELETE后重读同一主体,不恢复关注、不推断对方方向。举报用户沿用私有EVIDENCE、幂等收件和现有举报列表显式scope兼容,不自动处罚。
2026-11-20统一媒体交付已部署到唯一正式环境(运行配置仍为dev):已认证App成功JSON按需返回统一mediaDelivery,能力头不再选择格式,服务端决定CDN/OSS/API。业务ID和权限保持,文件通过返回的transport及授权加载;字段、缓存、单项失败与设备验收见统一媒体交付。后台网页仍使用独立管理员协议。