GET/api/v1/me/home
App Bearer、完整客户端头;正式HTTPS及JSON JWEJSON 响应接入指南 ↗

读取我的主页汇总

请求参数

无业务正文、无分页或用户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任务单独完成,不能将后端字段完成标记为客户端彩框已验收。