读取我的主页汇总¶
请求参数¶
无业务正文、无分页或用户ID参数。只读取Bearer所属本人;当前发行渠道与平台沿用登录会话绑定,不接受查询其他账号。完整八项公共请求头必填,提示及展示名称按Accept-Language,未知或缺省语言回退英文。
此接口替代「我的」首屏分别读取me、关系统计、钱包、本人动态分页总数、点赞分页总数以及完整国家/语言目录。二级分页、编辑和安全操作继续使用原领域接口;首屏不下载全部目录或动态正文。
请求示例¶
以下是显式dev固定码环境的明文示例,Token和追踪头由调用端生成;正式环境使用可信HTTPS与真实JWE,GET信封放X-Budyoo-JWE,不添加业务正文。
GET /api/v1/me/home HTTP/1.1
Authorization: Bearer <本次登录的accessToken>
X-Client-Type: app
X-Platform: android
X-App-Version: 1.0.0
X-App-Build: 1
X-Channel: xiaomi
X-Device-Id: 00000000-0000-4000-8000-000000000001
X-Request-Id: 00000000-0000-4000-8000-000000000002
X-Request-Timestamp: <当前13位毫秒时间戳>
Accept-Language: zh-CN
成功响应¶
以下成功示例按2026-11-20已部署的统一协议展示;CDN示例为合成对象,默认头像示例使用API通道,真实地址及权限以服务端返回为准。
新增非空followerNotifications:{unreadCount,lastSequence,readSequence},三个值均为非负整数,readSequence≤lastSequence;无记录为0。它表示本人持久粉丝提示,不用总数差值推算。历史关注基线为已读,普通GET不清零;完整字段、取关/屏蔽/注销及并发确认语义见确认粉丝列表已读。
HTTP200、Cache-Control:no-store。以下合成示例不代表线上账号或赠送余额。
{
"code": "SUCCESS",
"message": "操作成功。",
"data": {
"account": {
"userId": "00000000-0000-4000-8000-000000000003",
"registrationStatus": "COMPLETE",
"nextStep": "HOME",
"country": "cn",
"nickname": "示例",
"gender": "female",
"birthday": "2000-01-02",
"spokenLanguage": "zh",
"learningLanguage": "en",
"introduction": "喜欢学习语言",
"avatarId": null,
"interests": [
"chat"
],
"registrationStep": 4,
"vipGateEnabled": false,
"vipActive": false,
"vipRequired": false,
"completionPercent": 70,
"moderation": {
"avatar": {
"status": "EMPTY",
"reviewId": null,
"reason": null,
"submittedAt": null,
"reviewedAt": null
},
"nickname": {
"status": "PENDING",
"reviewId": "00000000-0000-4000-8000-000000000002",
"reason": null,
"submittedAt": "2026-11-06T00:00:00Z",
"reviewedAt": null
},
"introduction": {
"status": "PENDING",
"reviewId": "00000000-0000-4000-8000-000000000003",
"reason": null,
"submittedAt": "2026-11-06T00:00:00Z",
"reviewedAt": null
},
"published": {
"avatarId": null,
"nickname": null,
"introduction": null
}
}
},
"display": {
"language": "zh-CN",
"country": {
"id": "cn",
"name": "中国",
"names": {
"zh-CN": "中国",
"en": "China",
"ja": "中国",
"ko": "중국"
},
"flagUrl": "/api/v1/media/country-flags/cn"
},
"spokenLanguage": {
"id": "zh",
"name": "中文",
"names": {
"zh-CN": "中文",
"en": "Chinese",
"ja": "中国語",
"ko": "중국어"
},
"nativeName": "中文"
},
"learningLanguage": {
"id": "en",
"name": "英语",
"names": {
"zh-CN": "英语",
"en": "English",
"ja": "英語",
"ko": "영어"
},
"nativeName": "English"
}
},
"summary": {
"relationships": {
"following": 0,
"followers": 0,
"friends": 0,
"visitors": 1,
"blocked": 0,
"followerNotifications": {
"unreadCount": 0,
"lastSequence": 0,
"readSequence": 0
}
},
"wallet": {
"balance": 0,
"unit": "DIAMOND",
"rechargeAvailable": false,
"updatedAt": null
},
"postsCount": 0,
"likedPostsCount": 0,
"recentPosts": [],
"recentVisitors": [
{
"userId": "00000000-0000-4000-8000-000000000004",
"avatarUrl": "/api/v1/media/user-avatars/00000000-0000-4000-8000-000000000004",
"vipActive": false
}
]
}
},
"errors": [],
"mediaDelivery": [
{
"path": "/api/v1/media/user-avatars/00000000-0000-4000-8000-000000000004",
"url": "/api/v1/media/user-avatars/00000000-0000-4000-8000-000000000004",
"access": "API",
"expiresAt": null,
"cacheKey": "/api/v1/media/user-avatars/00000000-0000-4000-8000-000000000004",
"cacheMaxAgeSeconds": 0,
"code": "SUCCESS",
"transport": "API",
"requestHeaders": {},
"authorization": null
}
]
}
| data字段 | 类型/可空 | 说明 |
|---|---|---|
| account | object,非空 | 字段和语义与当前用户一致;先判断注册及VIP准入,再显示主页 |
| account.completionPercent | integer,非空 | 后端按已保存本人资料计算的0–100整数百分比,只读,不带百分号;规则见资料完善度 |
| display.language | string,非空 | 本次归一界面语言zh-CN/en/ja/ko |
| display.country | object,可空 | 本人已选国家的id、当前name、四语names和flagUrl;无选择或历史未知代码为null |
| display.spokenLanguage/learningLanguage | object,可空 | 本人两种已选资料语言的id、当前name、四语names及nativeName;未选择或历史未知为null |
| summary | object,可空 | 仅资料COMPLETE且vipRequired=false才返回,否则null,不把未准入当真实零统计 |
| summary.relationships | object,非空 | 好友为双向关注,其他计数与关系统计同一规则;不含设计增长数 |
| summary.recentVisitors | array,不为null,最多3项 | 本人最近有效独立访客的头像预览,按最近visited_at、访客UUID倒序;无访客返回[]。与relationships.visitors及访客列表共用账号/双向屏蔽过滤;总人数可能大于3,不能从数组长度推算 |
| summary.recentVisitors[].userId | UUID,非空 | 真实访客用户编号;同一访客只占一项,重复访问更新最近时间,自看不记录 |
| summary.recentVisitors[].avatarUrl | string或null | 服务端按查看者选择可见头像并返回交付URL;无引用使用API默认图,无权/媒体故障为null。公共加载组件处理授权,不给CDN/OSS附加本站Bearer |
| summary.recentVisitors[].vipActive | boolean,非空 | 该userId对应访客在本次读取时的实际有效VIP;已生效且未到期/撤销才为true,dev且非prod沿用管理员测试覆盖。与当前登录者account.vipActive及渠道门槛无关,不从缺失值推断false |
| summary.wallet | object,非空 | 与钱包余额相同的真实余额、单位、充值可用性和更新时间;当前真实支付未接通 |
| summary.postsCount | integer,非负 | 本人未删除动态数,包括本人待审/驳回/隐藏状态,不表示公开可见数量 |
| summary.likedPostsCount | integer,非负 | 与本人点赞列表total相同,过滤未审核/隐藏/删除/失活作者和双方屏蔽内容 |
| summary.recentPosts | array,非空 | 本人最新最多3条未删除动态的封面索引,按createdAt、id倒序;无动态为[],待审/驳回/隐藏仍仅本人可见;不包含正文、作者、评论或媒体字节 |
| summary.recentPosts[].id | UUID,非空 | 本人动态编号;一条多图动态只占一项 |
| summary.recentPosts[].kind | string,非空 | TEXT/IMAGE/VIDEO/VOICE;用于没有封面时的对应类型图标 |
| summary.recentPosts[].thumbnailUrl | string,可空 | IMAGE取position最前的绑定照片,VIDEO取已保存封面;返回经统一交付转换的真实URL,其余/无封面/媒体不可用为null。业务path在mediaDelivery中保留 |
| summary.recentPosts[].thumbnailUrls | (string或null)[],数组非null | 有序媒体地址,最多3项;IMAGE按照片position、id取前3张,VIDEO有封面时1项,TEXT/VOICE及无封面为[]。单项不可用时保留位置并置null,原因见mediaDelivery,不携带字节 |
| summary.recentPosts[].photoCount | integer,0–9 | 本条IMAGE动态全部已绑定照片张数,包括未在预览数组显示的照片;其余类型固定0。IMAGE的thumbnailUrls长度等于min(photoCount,3);旧thumbnailUrl保持等于数组首项,无首项则为null |
失败响应¶
| HTTP | code | 条件/处理 |
|---|---|---|
| 400 | INVALID_CLIENT_HEADERS/INVALID_APP_CHANNEL | 公共头不合法、未知渠道或平台不配对 |
| 400 | ENCRYPTION_REQUIRED/INVALID_ENCRYPTED_REQUEST | 应加密场景缺失真实JWE或认证失败 |
| 401 | UNAUTHORIZED | 无凭证、过期/撤销、安装或会话渠道/平台不匹配,按会话失效处理 |
| 403 | ACCOUNT_BANNED/DEVICE_BANNED/NETWORK_BANNED | 原封禁链继续拦截,不通过汇总接口绕过 |
| 404 | NOT_FOUND | 本人资料不存在 |
| 426/429 | HTTPS_REQUIRED/TOO_MANY_REQUESTS | 传输要求或网关限流 |
| 503 | SERVICE_UNAVAILABLE | 任一必要领域或访客会员读取失败;整体失败,不降级伪造零值、false或部分成功 |
固定code不翻译,message和字段错误支持中英日韩,缺省英文。未注册完成/待VIP返回200和summary=null是导航读取边界,本汇总响应不返回业务统计,并保持原有资产查询权限及其他受保护业务的403拦截。
接入说明¶
2026-11-20统一媒体交付已部署到唯一正式环境(运行配置仍为dev):已认证App成功响应自动替换受支持用户媒体URL并按需附加顶层mediaDelivery,不再要求能力头;无头、cdn-v1和oss-v1均使用同一结构。服务端选择CDN/OSS/API,客户端按transport加载;原ID、版本、权限、JWE与JSON的no-store保持。非空avatarId及albumPhotoIds按统一规则补充avatarUrl/albumPhotos,单项媒体依赖失败不推翻已提交业务。完整字段、缓存与Flutter验收见统一媒体交付。
本响应直接带回data.account.completionPercent,前端使用服务端分数,不再按字段数量自行均分,不需要新增请求。本页成功示例按无已绑定相册计算,相册存在性由服务端读取,无需客户端补拉相册。
新增moderation对象,三项avatar/nickname/introduction分别返回status、reviewId、reason、submittedAt及reviewedAt,另有published保存当前实际公开值。类型、可空范围、状态和示例见逐项资料审核。本人响应的原头像、昵称、签名继续表示本人提交内容;保存或注册完成只表示自动进入审核,公开页面只取最后通过值,首次无通过值使用默认头像/四语默认昵称/空签名。审核不新增注册步骤、不改变渠道VIP,其他字段或无变化保存不重复提审;清空头像或签名立即撤下。
首屏、下拉刷新、恢复前台和二级页返回统一读取本接口,先复用account更新当前会话及注册/VIP路由,再使用同一响应更新所有首屏数字和display名称;不要随后再次并行调用上述旧首屏接口。头像按account.avatarId走原鉴权PNG接口,国旗按display.country.flagUrl走公开SVG接口,媒体字节不塞入JSON,已有缓存可复用。
2026-11-09按最新多图预览要求,保留recentPosts最多3条真实动态及旧thumbnailUrl,兼容新增thumbnailUrls和photoCount,不新增接口或首屏请求。客户端按最近动态及其内部照片顺序取最多3格;例如同一条动态有5张照片,返回1条recentPosts、3个thumbnailUrls和photoCount=5,显示前三张并在最后一格标+2,postsCount仍为1。一张或两张也使用相同方形格,不再把单图裁成长条;45px预览行内按三列槽位计算方形边长、最大45px、间距5px。旧客户端忽略新增字段,新客户端遇到尚未升级的旧响应仅使用真实首张封面、张数未知,不补读列表或详情猜测。只有postsCount=0才显示去发布。照片和海报继续使用原鉴权路径及缓存,单图失败只重试本图;文本、语音和无封面视频保留类型图标。点击卡片仍进入原我的动态列表。
最近访客卡片直接使用summary.recentVisitors的服务器顺序展示最多3个头像,总人数始终读取summary.relationships.visitors。成功无访客时返回recentVisitors=[]及visitors=0;超过3人时预览仍为3项,不能用预览长度代替总数。成功的完整新响应中,预览长度等于min(relationships.visitors,3)。访客数组每项只包含userId、avatarUrl、vipActive三个字段,不返回昵称、头像编号、私有资料或媒体字节。已保存但未通过公开审核的头像不影响地址返回;由用户头像读取按当前Bearer选择公开头像或默认PNG,Flutter不能因缺少公开avatarId跳过图片。媒体读取失败仍按原媒体协议处理,不把故障伪装为默认头像。
首屏继续只读取这一份home业务JSON,不额外调用relationships、不逐人读取公开主页来拼头像,避免新增请求和反向记录访问。头像下载仍走原鉴权路径和按账号隔离的缓存。旧客户端忽略新增字段;若新客户端读到尚未升级的旧响应,可保留人数并暂不展示预览,不能用设计头像补齐或发额外请求。点击访客卡片后才进入原访客分页。
成功空结果才显示0;请求失败保留同账号最后成功快照并提供重试,首次失败显示未知/错误,不取设计人物、余额或计数补齐。退出/换号/切语的迟到响应仍按会话代次隔离。编辑页进入后才读取完整选择目录;动态/关系列表按用户实际打开后分页。
访客会员字段由服务端返回,true表示该访客的有效VIP,false表示已确认无有效权益;不使用当前查看者的account.vipActive、vipGateEnabled或本机身份替代。前端可据此选择会员渐变或普通边框,不增加会员/逐人资料请求。新服务成功响应始终完整返回非空boolean,不返回字符串、null或缺省值;旧客户端可忽略新增字段。新客户端若兼容尚未升级的旧服务,应把缺失字段保留为未知状态及中性外观,不把未知认定为非VIP。会员状态每次home读取重新判断,不固化为访问发生时状态;空预览及summary=null不查询访客权益,会员依赖异常整份503。
聚合发生在服务器领域服务,使用同一只读REPEATABLE_READ数据库快照;通过各模块api复用规则,动态数字继续执行总数投影,recentPosts另以有界投影只取最多三条UUID、类型、每条已有的前三张图片/视频封面路径及已绑定照片总数,不取第一页正文、评论、作者资料或媒体字节。recentVisitors经social/api使用独立LIMIT 3投影,仅读取访客编号并生成原头像路径;personal通过membership/api/VipMemberships一次批量读取预览中去重访客的当前有效权益,不读取完整关系列表或逐人公开资料;与计数处于home同一只读快照,预览依赖失败令整份响应失败。各原接口保持兼容及二级用途。2026-11-06已部署,597项服务器回归全部通过(0失败/错误/跳过),含新增12项主页汇总测试:原领域总数一致、不读取分页正文、四语及英文回退、凭据/安装/渠道校验、未完成及VIP待准入统计隔离、封禁、整体503和并发更新下快照一致性。真实入口9项边界检查通过,覆盖App开发HTTP入口匿名/错误Token/缺失公共头/四语及英文回退、no-store,以及后台专用受信HTTPS不承载App路径的既有404隔离。没有创建App测试账号或修改线上资料;已登录成功数据与JWE以隔离服务器测试为准,不把匿名检查当成真机或真实账号全链路验收。Flutter配套单请求及生命周期验证由客户端任务维护。
验证范围¶
2026-11-09多图扩展基于当前已发布版本,只叠加本次查询、DTO、测试及契约。服务器隔离PostgreSQL/Redis的MyHomeIntegrationTest 12项、MyHomePreviewIntegrationTest 6项,以及包边界、模块依赖和接口文档11项,共29项通过,0失败/错误/跳过;通过真实HTTP控制器及JWE验证最多三条本人记录、有序前三张与真实总数、未绑定照片排除、视频海报、注册/VIP准入、失败与一致快照。原单封面字段保留,无新增接口或数据库迁移;不修改运行账号、动态、照片或审核状态。Flutter另有29项聚合、严格字段、多图/单图、小屏与缓存回归;设备显示由客户端正式流程验证,不将隔离合成数据当作真实账号验收。
2026-11-10已部署最近访客预览扩展。服务器隔离PostgreSQL/Redis完整clean verify共927项通过,0失败/错误/跳过;新增MyHomeVisitorsIntegrationTest 11项经真实HTTP控制器及JWE覆盖0/1/3/超过3位、重复访问与自看、稳定排序及本人作用域、双方屏蔽和失活/未完成过滤、没有已审头像时实际读取默认PNG、注册/VIP准入、投影失败整体503及计数与预览同一快照,原主页鉴权/公共头/渠道和多图预览回归一并通过。线上仅使用既有空闲合成开发账号,按现有固定码HTTP明文兼容协议核对四语home新空数组、总数与访客列表一致、no-store、匿名401及现有访客头像PNG可读,退出测试会话;未新增账号、访客或修改资料。当前App公网未提供正式HTTPS,线上不把HTTP明文验证当作真实JWE或安全传输验收。Flutter仍需按新字段展示首页头像,0/1/3/超过3位、默认图、换号与迟到响应的页面/设备验收由客户端任务完成,不将后端部署标记为客户端修复。
2026-11-10最近访客会员字段通过服务器隔离PostgreSQL/Redis完整clean verify:946项通过,0失败/错误/跳过。新增MyHomeVisitorVipIntegrationTest 19项经真实HTTP控制器及JWE覆盖未开通/生效/到期/撤销/未来生效、同页混合会员、仅批量查询预览三人、查看者与渠道门槛独立、开发测试覆盖、后续读取变化、屏蔽/失活过滤、会员依赖503四语及英文回退、空数组/summary=null、同一快照及鉴权;原访客11项与主页、多图、模块和接口文档回归保持。所有会员及访问写入只在隔离测试库,不修改运行用户、权益或访客。部署服务器已发布20261110-home-visitor-vip-110420,Flyway保持V40;运行JAR与测试制品摘要、源码清单与镜像标签、健康、Nginx及备份独立恢复均核对通过。真实入口15项检查覆盖既有空闲合成开发账号的四语/英文回退、成功空访客数组、no-store、匿名/错误Token/安装/渠道/缺头及退出失效,测试会话已退出;线上未新增账号、访客或修改会员,原访问记录摘要保持。当前App公网按既有固定码HTTP明文兼容协议验证,非空混合会员及真实JWE的正向场景以隔离服务器回归为准,不将HTTP检查称为正式安全传输验收。客户端边框展示及真机验收由Flutter任务单独完成,不能将后端字段完成标记为客户端彩框已验收。