GET/api/v1/admin/users/{userId}/profile
管理员Cookie,ADMIN_USER_PROFILES_READJSON 响应接入指南 ↗

读取用户详细资料

请求参数

面向后台网页,要求可信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和接口契约未改变;其他写接口的验收范围仍以既有测试为准。物理文件清理、公开图片分发、审核、好友、钱包和聊天不在本批范围。