读取用户详细资料¶
请求参数¶
面向后台网页,要求可信HTTPS、独立HttpOnly Cookie及OWNER或VIEWER的ADMIN_USER_PROFILES_READ权限。App Bearer不能调用。JSON请求与响应必须使用真实JWE。若发送Origin也必须与后台源一致,跨站请求拒绝。
公共头见请求头,四语见公共响应,身份见后台协议。客户端类型和图片UUID本身不授予权限。
路径userId必填,为目标用户UUID;不存在返回404。无查询参数。 无业务请求体。
请求示例¶
示例UUID为合成数据;deviceId必须复用当前安装,不要每次新建。以下示例覆盖八项公共头;禁止日志输出Cookie或Bearer。
import {createJweEncryption} from '../../examples/budyoo-encryption.mjs';
const url = new URL('/api/v1/admin/users/11111111-1111-4111-8111-111111111111/profile', location.origin);
const headers = {
'Accept-Language': 'zh-CN',
'X-Client-Type': 'admin', 'X-Platform': 'web',
'X-App-Version': '1.0.0', 'X-App-Build': '1', 'X-Channel': 'admin_web',
'X-Device-Id': installationId, // 当前浏览器已持久保存的安装UUID
'X-Request-Id': crypto.randomUUID(), 'X-Request-Timestamp': String(Date.now()),
};
const codec = createJweEncryption({baseUrl: location.origin});
const encrypted = await codec.prepare({url, method: 'GET', headers, body: null});
const response = await fetch(url, {method: 'GET', headers: encrypted.headers,
body: encrypted.body, credentials: 'same-origin', redirect: 'error'});
const result = await encrypted.decode(response); // 必须认证解密后才使用业务结果
必须从已验证的HTTPS同源页面调用;Origin和Cookie由浏览器维护,不在脚本写入Cookie。后台账号列表的“查看详情”弹窗已通过统一JWE请求封装接入,每次打开读取最新资料。
成功响应¶
HTTP200,Cache-Control:no-store;合法请求ID回传。外层为JWE,下方是解密后的JSON。
{
"code": "SUCCESS",
"message": "操作成功。",
"data": {
"userId": "11111111-1111-4111-8111-111111111111",
"registrationStatus": "COMPLETE",
"version": 1,
"updatedAt": "2026-11-03T10:00:00Z",
"country": "cn",
"nickname": "合成用户",
"gender": "female",
"birthday": "2000-01-02",
"spokenLanguage": "zh",
"learningLanguage": "en",
"introduction": "喜欢旅行和摄影",
"avatarId": null,
"interests": [
"photo",
"travel"
],
"albumPhotoIds": [],
"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
}
}
},
"errors": []
}
| data字段 | 类型 | 可空 | 说明 |
|---|---|---|---|
| userId | string(UUID) | 否 | 资料所属用户,不由请求体指定 |
| registrationStatus | string | 否 | INCOMPLETE/COMPLETE;只读,后台可读取未完成资料 |
| version | integer(int64) | 否 | 从0开始;每次编辑保存递增,下一次作为expectedVersion |
| updatedAt | string(date-time) | 否 | 带时区ISO 8601;仅展示,不能代替version |
| country | string | 是 | 249国家/地区目录的小写代码 |
| nickname | string | 是 | 新写入1–8个UTF-16代码单元;历史昵称按原值返回 |
| gender | string | 是 | male/female,注册后只读 |
| birthday | string(date) | 是 | YYYY-MM-DD,1900-01-01至服务端当天 |
| spokenLanguage | string | 是 | 字典中的单个我会的语言代码 |
| learningLanguage | string | 是 | 字典中的单个学习语言代码 |
| introduction | string | 是 | 最多30个UTF-16代码单元;编辑后允许空字符串 |
| avatarId | string(UUID) | 是 | 本人上传头像引用,无头像为null |
| interests | string[] | 否 | 按代码升序,完成账号保留1–6个 |
| albumPhotoIds | string(UUID)[] | 否 | 0–9张;保留旧照片相对顺序,新照片按提交顺序追加 |
失败响应¶
| HTTP | code | 条件 |
|---|---|---|
| 400 | BAD_REQUEST/VALIDATION_FAILED | 路径UUID、请求格式或必填参数不合法 |
| 400 | INVALID_CLIENT_HEADERS | 公共头缺失、重复或格式错误 |
| 401 | UNAUTHORIZED | 未登录、会话失效或安装不匹配 |
| 403 | FORBIDDEN/ADMIN_CSRF_INVALID | 无对应权限、Origin或CSRF不符 |
| 404 | NOT_FOUND | 用户或归属范围内的图片不存在/已删除 |
| 426 | HTTPS_REQUIRED | 当前路径不允许明文HTTP |
| 503 | SERVICE_UNAVAILABLE | 数据库/Redis依赖暂不可用 |
| 400/409 | 加密协议错误码 | JWE缺失、篡改、过期、重放,按公共加密协议处理 |
错误结构示例:
{"code":"UNAUTHORIZED","message":"按Accept-Language返回中文、英文、日文或韩文提示","data":null,"errors":[]}
未知或缺省语言回退英文;code不翻译。字段校验明细在errors[].field/message。网关可能先返回429/413,不能当成认证过的JWE业务响应。
接入说明¶
新增moderation对象,三项avatar/nickname/introduction分别返回status、reviewId、reason、submittedAt及reviewedAt,另有published保存当前实际公开值。类型、可空范围、状态和示例见逐项资料审核。本人响应的原头像、昵称、签名继续表示本人提交内容;保存或注册完成只表示自动进入审核,公开页面只取最后通过值,首次无通过值使用默认头像/四语默认昵称/空签名。审核不新增注册步骤、不改变渠道VIP,其他字段或无变化保存不重复提审;清空头像或签名立即撤下。
新编辑接口与注册草稿分开:不会回退registrationStep,不改变性别、身份或VIP。先读取version及照片编号,再进入编辑;App旧GET /me继续承担登录恢复,不添加进度请求。
当前后台详情仅查看已保存的基本资料、介绍、语言、兴趣及相册,不执行资料修改;未填写字段显示“未设置”,未完成注册账号也可查看。生日保持无时区日期,国家/语言名称按当前界面本地化,兴趣文字沿用注册/编辑UI的108项四语映射。关闭后或切换用户时忽略旧请求结果,失败显示重试,不展示其他用户的缓存资料;资料和图片不写入浏览器持久存储。四语桌面/手机、完整/未完成资料、请求失败重试及迟到响应隔离已通过真实浏览器验证,资料请求与响应仍为JWE。
已有服务器隔离PostgreSQL/Redis完整整合回归覆盖30/31字符、鉴权、字段白名单、相册归属与九张上限、并发版本、两端真实JWE、后台CSRF和审计回滚;真实Servlet验证10MiB上传与超限,隔离Nginx验证媒体路径大小。实现位于profile、media及admin/users模块,跨业务只走api。V9及媒体网关已部署;后台账号列表、头像与只读详情弹窗已接入,后台资料编辑/相册管理动作及Flutter接入以各端实际状态为准。本次只有网页读取接入,Java和接口契约未改变;其他写接口的验收范围仍以既有测试为准。物理文件清理、公开图片分发、审核、好友、钱包和聊天不在本批范围。