读取用户主页主体¶
请求参数¶
| 参数 | 位置 | 类型与必填 | 含义 |
|---|---|---|---|
| userId | 路径 | UUID,必填 | 目标用户的内部UUID,身份来自当前Bearer |
无业务查询参数、无请求体。要求ROLE_USER、本人账号ACTIVE且注册完成、满足当前会话渠道VIP准入;目标必须ACTIVE且COMPLETE。不存在、禁用、注销、未完成或对方单独屏蔽的目标统一404;我方已屏蔽且目标仍有效时只返回BLOCKED_BY_ME受限快照。自看允许,仍使用公开投影且不提供面向他人的菜单和底栏操作。
除目标用户动态外,用户主页主体仅请求本接口一次;刷新重读本接口,不并发拼接本人接口、关系统计、全量国家/语言/兴趣目录或逐人公开资料。头像、国旗、兴趣图标和照片按返回路径单独读取并使用既有身份隔离缓存。
所有请求均校验八项公共头,安装ID与当前会话一致,平台和渠道沿用会话绑定。JSON遵循统一响应与AES/JWE,正式要求可信HTTPS,GET信封放X-Budyoo-JWE。当前显式dev固定码/HTTP兼容仅按公共协议执行。提示及display.name使用Accept-Language,支持中英日韩,缺省/未知英文,code不翻译。
正常VISIBLE状态读取他人主页会记录真实访客:同一目标/访客只有一条,重复读取更新最近访问时间,自看不记录。全部必要投影成功后才写入,失败事务回滚,受限态不记访客,不能通过其他接口拼装绕过权限。
请求示例¶
UUID为合成示例;Token、安装ID、请求ID、时间戳和JWE信封均由当前会话统一客户端生成。
GET /api/v1/users/00000000-0000-4000-8000-000000000001/profile HTTP/1.1
Authorization: Bearer <当前accessToken>
Accept-Language: zh-CN
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-000000000002
X-Request-Id: 00000000-0000-4000-8000-000000000003
X-Request-Timestamp: <当前13位毫秒时间戳>
Accept: application/jose
X-Budyoo-Encryption: jwe-v1
X-Budyoo-JWE: <统一客户端生成的compact-JWE>
成功响应¶
以下成功示例按2026-11-20已部署的统一协议展示;CDN示例为合成对象,默认头像示例使用API通道,真实地址及权限以服务端返回为准。
HTTP200、Cache-Control: no-store。以下为认证解密后的完整合成示例,不代表线上人物或记录。
{
"code": "SUCCESS",
"message": "操作成功。",
"data": {
"profile": {
"userId": "00000000-0000-4000-8000-000000000001",
"publicId": "10000001",
"nickname": "示例用户",
"country": "cn",
"gender": "female",
"spokenLanguage": "zh",
"learningLanguage": "en",
"introduction": "喜欢学习语言",
"avatarId": null,
"interests": [
"chat"
]
},
"avatarUrl": "/api/v1/media/user-avatars/00000000-0000-4000-8000-000000000001",
"occurredAt": null,
"following": false,
"followsYou": true,
"vipActive": true,
"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"
},
"interests": [
{
"id": "chat",
"groupId": "friends",
"name": "日常聊天",
"names": {
"zh-CN": "日常聊天",
"en": "Daily chats",
"ja": "日常トーク",
"ko": "일상 대화"
},
"iconId": "ff24f9fd-b87e-5b9f-9d15-929be1f280a2",
"iconUrl": "/api/v1/media/interest-icons/ff24f9fd-b87e-5b9f-9d15-929be1f280a2",
"enabled": true,
"selectable": true,
"sortOrder": 1,
"version": 0
}
]
},
"birthday": "2000-01-02",
"age": 26,
"ageAsOf": "2026-11-11",
"birthdayVisibility": "VISIBLE",
"presence": {
"status": "ONLINE",
"visibility": "VISIBLE",
"observedAt": "2026-11-11T00:00:00Z",
"lastActiveAt": null
},
"relationships": {
"friends": 1,
"followers": 2,
"following": 3
},
"album": {
"visibility": "VISIBLE",
"total": 1,
"photos": [
{
"id": "00000000-0000-4000-8000-000000000004",
"position": 0,
"url": "https://media.budyoo.cn/media/album-photos/00000000-0000-4000-8000-000000000004.png",
"contentType": "image/png",
"sizeBytes": 2048
}
]
},
"capabilities": {
"isSelf": false,
"canFollow": true,
"canUnfollow": false,
"canBlock": true,
"canChat": false,
"chatUnavailableReason": "NOT_IMPLEMENTED",
"canViewRelationshipLists": false,
"canUnblock": false,
"canReport": true
},
"viewState": "VISIBLE",
"blockedByMe": false,
"identity": {
"userId": "00000000-0000-4000-8000-000000000001",
"nickname": "示例用户"
}
},
"errors": [],
"mediaDelivery": [
{
"path": "/api/v1/media/user-avatars/00000000-0000-4000-8000-000000000001",
"url": "/api/v1/media/user-avatars/00000000-0000-4000-8000-000000000001",
"access": "API",
"expiresAt": null,
"cacheKey": "/api/v1/media/user-avatars/00000000-0000-4000-8000-000000000001",
"cacheMaxAgeSeconds": 0,
"code": "SUCCESS",
"transport": "API",
"requestHeaders": {},
"authorization": null
},
{
"path": "/api/v1/media/user-albums/00000000-0000-4000-8000-000000000001/00000000-0000-4000-8000-000000000004",
"url": "https://media.budyoo.cn/media/album-photos/00000000-0000-4000-8000-000000000004.png",
"access": "PUBLIC",
"expiresAt": null,
"cacheKey": "budyoo-media:v1:3c78b9220a12b56d82cd4655e3cb8ccbc39e58ad258f9a65db22b0d43cb3d0f3",
"cacheMaxAgeSeconds": 86400,
"code": "SUCCESS",
"transport": "CDN",
"requestHeaders": {
"X-Budyoo-Media-Path": "/api/v1/media/user-albums/00000000-0000-4000-8000-000000000001/00000000-0000-4000-8000-000000000004"
},
"authorization": {
"origin": "https://media.budyoo.cn",
"headerName": "X-Budyoo-Media-Token",
"credentialPath": "/api/v1/media/credentials"
}
}
]
}
先严格解析非空viewState、blockedByMe、identity和capabilities,再按状态解析主体。正常VISIBLE沿用原字段;BLOCKED_BY_ME仅返回下列最小data,完整资料相关字段显式null,不能将它们降级为普通VIP、未关注、0或无相册。以下示例表示data,不代表运行用户。
{
"profile": null,
"avatarUrl": null,
"occurredAt": null,
"following": null,
"followsYou": null,
"vipActive": null,
"display": null,
"birthday": null,
"age": null,
"ageAsOf": null,
"birthdayVisibility": null,
"presence": null,
"relationships": null,
"album": null,
"capabilities": {
"isSelf": false,
"canFollow": false,
"canUnfollow": false,
"canBlock": false,
"canChat": false,
"chatUnavailableReason": "NOT_IMPLEMENTED",
"canViewRelationshipLists": false,
"canUnblock": true,
"canReport": true
},
"viewState": "BLOCKED_BY_ME",
"blockedByMe": true,
"identity": {
"userId": "00000000-0000-4000-8000-000000000001",
"nickname": "示例用户"
}
}
除identity与capabilities及两个状态字段外,下表完整资料字段只描述VISIBLE态;受限态profile、avatarUrl、following、followsYou、vipActive、display、birthday、age、ageAsOf、birthdayVisibility、presence、relationships、album统一为null,occurredAt两态均null。
| 字段 | 类型/nullable | 语义 |
|---|---|---|
| viewState | string,非空 | VISIBLE正常详情或BLOCKED_BY_ME我方屏蔽最小身份;没有对方屏蔽方向字段 |
| blockedByMe | boolean,非空 | 当前Bearer本人是否已屏蔽目标,失败报错,不用客户端缓存或扫黑名单推断 |
| identity | object,非空 | 仅userId和nickname,昵称只取已审公开值或四语默认名,两态均可用作顶部标题;不包含头像、国家、会员或其他资料 |
| profile | VISIBLE为object,受限null | 保留原PublicProfile:userId/publicId、昵称、国家、性别、双语种、简介、avatarId及原兴趣编号。昵称、简介、avatarId只取最后已审公开值;无已审昵称用四语默认名。联系方式、本人草稿、审核原因、付款数据不返回 |
| avatarUrl | string或null | 后台按查看者选择本人绑定图或他人已审图并返回交付URL;受限/媒体故障为null,无引用使用API默认图。统一mediaDelivery提供授权,不据avatarId空值跳过加载 |
| occurredAt | null | 原兼容字段,主页不把本次访问时间当既有关系时间 |
| following、followsYou | VISIBLE为boolean,受限null | 当前查看者关注目标/目标关注查看者的真实方向 |
| vipActive | VISIBLE为boolean,受限null | 本条目标profile.userId当前有效VIP,生效且未到期/撤销才为true;dev且非prod复用原管理员测试覆盖。与查看者、vipRequired和渠道门槛独立 |
| display | VISIBLE为object,受限null | 所选目录投影,与本人编辑的ProfileEditorDisplay同源,不读取完整目录 |
| display.language | string,非空 | 归一后的zh-CN/en/ja/ko |
| display.country | object或null | 目标已选国家id、当前name、四语names、本站flagUrl;未知/空代码为null,profile原代码保留,不按IP推断 |
| display.spokenLanguage、learningLanguage | object或null | 每项单选id、name、四语names、nativeName;未知/空值为null |
| display.interests | array,非空 | 只含已选且目录仍有定义的条目,按profile.interests顺序;字段见示例及兴趣目录。已选停用项保留且enabled/selectable如实返回;未知历史ID仅在profile.interests保留,不伪造名称/图标 |
| birthday | YYYY-MM-DD或null | 详情专用的已保存结构化生日;仅本接口向有权限的已登录查看者展示,不扩展其他最小profile或匿名读取 |
| age | integer或null | 以birthday和ageAsOf计算的完整年数,服务端权威值,客户端不自行改算 |
| ageAsOf | VISIBLE为YYYY-MM-DD,受限null | 本次服务端UTC日历日期,年龄计算基准 |
| birthdayVisibility | VISIBLE为string,受限null | VISIBLE有有效日期及年龄;UNSET未填写,日期/年龄均null;UNAVAILABLE为无效历史日期,均null。当前没有单独隐藏生日设置,整体不可见目标直接404 |
| presence | VISIBLE为object,受限null | 目标真实长连接租约观测,详情专用,不暴露设备、票据、节点或路由 |
| presence.status | string,非空 | ONLINE存在有效租约;OFFLINE没有有效长连接;UNKNOWN表示长连接未启用,状态不可获知。OFFLINE不表示最近活跃、最近登录或App已退出 |
| presence.visibility | string,非空 | 启用且成功观测为VISIBLE;未启用为UNAVAILABLE。依赖故障整份503 |
| presence.observedAt | ISO 8601或null | 本次租约观测时间;UNKNOWN时null,独立于数据库快照时点 |
| presence.lastActiveAt | null | 目前没有持久的权威最近活跃时间,不伪造最近活跃文案 |
| relationships | VISIBLE为object,受限null | 目标friends/followers/following,均为非负long整数,好友为互相关注,仅统计ACTIVE/COMPLETE关联账号;不公开访客和黑名单 |
| album | VISIBLE为object,受限null | visibility、total、photos;只投影当前已审公开相册 |
| album.visibility | string,非空 | VISIBLE至少一张;EMPTY没有当前公开照片,不区分未设置、私有、待审、驳回、撤下,客户端隐藏整段相册 |
| album.total | integer,非空 | 等于photos长度,0–9 |
| album.photos | array,非空 | 按已审position升序,最多9张,不补候选图或其他账号照片 |
| photos[].id、position | UUID、integer,非空 | 不可变文件编号,位置0–8,单项撤下后可能有空位,不重新编号 |
| photos[].url | string,非空 | 逐次鉴权相册媒体,始终使用返回路径 |
| photos[].contentType、sizeBytes | string、long,非空 | 固定image/png及真实规范化文件字节数;最长边1024,具体宽高由图片解码获取,无宽高或独立版本字段,ID表示不可变文件 |
| capabilities | object,非空 | 下表的实际能力,不授予额外权限 |
| 操作能力字段 | 当前含义 |
|---|---|
| isSelf | 当前Bearer用户与目标相同 |
| canFollow | VISIBLE且非本人、当前未关注;操作沿用关注 |
| canUnfollow | VISIBLE且非本人、当前已关注;操作沿用取消关注 |
| canBlock | VISIBLE且非本人;沿用屏蔽,屏蔽后主体仅最小身份、其他受保护入口仍不可见 |
| canUnblock | 仅BLOCKED_BY_ME为true;沿用解除屏蔽,只撤销本人方向 |
| canReport | 非本人且本次主体可达为true;按举报用户真实收件,不假用动态ID |
| canChat | 固定false,当前尚无真实IM会话/消息业务入口,不使用静态聊天示例或假会话 |
| chatUnavailableReason | 固定NOT_IMPLEMENTED,稳定原因代码由客户端四语提示 |
| canViewRelationshipLists | 固定false,本页三项数字仅展示,未开放他人关系列表;不得将目标UUID套到/me路径查询 |
自看时canFollow/canUnfollow/canBlock/canUnblock/canReport/canChat均false,客户端隐藏右上三点及底部关注/聊天按钮;顶部标题统一读取identity.nickname。能力只是本次快照,操作仍按当时服务器权限重新校验,超时或失败不能假成功。VIP为true时客户端绘制现有会员头像边框、昵称渐变及本地V徽章,不增加颜色或徽章图片URL。
所有names包含zh-CN/en/ja/ko四个键。成功无相册为{"visibility":"EMPTY","total":0,"photos":[]};无生日为birthday=null、age=null、birthdayVisibility=UNSET。头像、昵称、简介和相册公开值只取已审核且仍公开的引用,生日/性别/国家/双语种/兴趣为已保存且经过现有字段校验的结构化资料,不新增自动审核或生日隐私设置。
失败响应¶
| HTTP | code | 处理 |
|---|---|---|
| 400 | BAD_REQUEST/INVALID_CLIENT_HEADERS | 目标UUID或公共头不合法 |
| 401 | UNAUTHORIZED | 匿名、凭据失效、安装/渠道不一致或已退出 |
| 403 | FORBIDDEN/ACCOUNT_DISABLED | 查看者角色、账号或注册/VIP准入不满足 |
| 404 | NOT_FOUND | 目标不存在、失活、注销、未完成或对方单独屏蔽,统一不可见;不提供方向解释 |
| 426 | HTTPS_REQUIRED | 当前模式要求可信安全传输 |
| 503 | SERVICE_UNAVAILABLE | 数据库、VIP、所选目录、已审相册元数据或在线租约等必要依赖失败,整份失败并回滚访问 |
| 500 | INTERNAL_ERROR | 未预期错误,沿用标准错误响应 |
失败不得降级普通VIP、0个关系、空相册、离线或部分成功。四语message、稳定code和JWE失败按公共协议处理;图片下载失败独立保留错误,不能改写成功主体里的照片数量。
接入说明¶
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验收见统一媒体交付。
我方屏蔽优先于反向检查:本人方向存在时只查目标最小已审昵称身份,不查询或返回对方是否也屏蔽;双方屏蔽与仅本人屏蔽具有相同受限输出。目标不可用仍404,必要状态或身份依赖故障503。受限态不查完整资料、VIP、所选目录、在线租约、关系数字或相册元数据,不记访客。头像、公开相册、动态、关注等原双向屏蔽权限不放开;头像和公开相册404,原用户动态列表仍200且items=[]、total=0、hasMore=false,已知动态详情404,不改变既有分页契约。
客户端菜单只按真实能力显示举报、拉黑/取消拉黑及取消。PUT/DELETE /api/v1/me/blocked-users/{userId}成功返回data=null后,重新读取这一份主体确认;解除不恢复关注。解除后404只显示目标不可用,不据此猜测对方屏蔽。写入失败或结果不明不本地翻转blockedByMe、不自动重放;可先只读确认主体。
数据库内容在同一REPEATABLE_READ事务内聚合;账号按固定UUID顺序加锁,串行屏蔽、注销与资料审核。目标VIP只查询一次,所选目录只读对应项,相册元数据一次批量读取实际已审文件,空相册跳过;主体JSON不读取图片字节。在线租约来自独立Redis观测,具有自己的observedAt,不宣称跨数据库和Redis原子快照。
相册通过前仅本人私有入口可读,待审或驳回时保留最后通过位置;清空或下架立即撤销相应公开引用。公开媒体对本人也只认可已审引用,不能借self读取候选或暂存。头像继续按原Bearer选择本人最新绑定/他人公开值,见资料审核。
动态继续使用GET /api/v1/users/{userId}/posts真实分页,直接复用当前动态卡片及其公开可见性、VIP、当前查看者评论计数和媒体契约;本响应不包含动态列表,也不以设计数据补齐。刷新、上下拉页码和迟到响应处理遵循原动态协议。
客户端保留用户主页原稿布局及四语显示,只有成功EMPTY才隐藏相册;加载失败保留错误与重试,切换账号/退出隔离主体和媒体缓存,不能复用旧Bearer的授权结果。
2026-11-11服务器隔离PostgreSQL/Redis完整clean verify通过1070项,0失败/错误/跳过;保留原主体、公开相册与真实租约49项,新增菜单/受限快照20项、用户举报15项、安全/回滚/注销16项、V40→V41升级1项。验证本人全部他人动作关闭、本人屏蔽最小身份与14个null字段、双向屏蔽同快照、反向或不可用404、未审候选不回退、无完整依赖及访客写入、真实解除且不恢复关注、公开媒体404及原动态200空页/已知详情404,并覆盖四语回退、必要依赖503与身份/公共头/准入。正向他人访问、屏蔽、举报及审核写入均在隔离库经HTTP控制器及真实JWE验证;后台浏览器隔离夹具通过四语×桌面/手机8组,用户目标不请求伪造动态,内容/评论关联和VIEWER只读保持,无运行请求或写入。
开发版本20261111-user-menu-125906已发布,Flyway为V41;备份独立恢复、构建/运行JAR及源码/镜像摘要、健康与后台产物核对通过。公网35项dev HTTP标准JSON检查通过:仅使用既有空闲合成账号自看五种语言、四张已审照片、三种举报列表scope与旧默认、参数/身份/安装/渠道/公共头及退出失效;新收件只核对自报400、不存在404和未知字段400,未在运行环境创建举报、屏蔽或访问。验收账号已退出,运行资料/公开相册摘要保持;一条发布前发生的既有访客时间刷新已与发布前备份逐行核对,未回写或恢复运行数据。正向他人访问、屏蔽/解除和举报证据写入仍由隔离HTTP/JWE测试覆盖,客户端设备闭环由Flutter任务验收。V41禁止自动切回旧程序,故障使用已验证备份受控恢复或兼容修复。