GET/api/v1/admin/catalogs/profile
管理员Cookie,ADMIN_USER_PROFILES_READJSON 响应接入指南 ↗

后台资料编辑字典

请求参数

OWNER及VIEWER可读;必须HTTPS、真实JWE及独立Cookie。八项公共头全部必填,固定admin/web/admin_web;App Bearer不可用。无路径参数、查询参数或业务正文。

请求示例

在已登录且证书可信的后台同源页面执行;安装ID必须与会话一致。浏览器自动管理Origin与Cookie。

import {createJweEncryption} from '../../examples/budyoo-encryption.mjs';
const url = new URL('/api/v1/admin/catalogs/profile', location.origin);
const codec = createJweEncryption({baseUrl: location.origin});
const encrypted = await codec.prepare({url, method: 'GET', body: null, 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, 'X-Request-Id': crypto.randomUUID(),
  'X-Request-Timestamp': String(Date.now()),
}});
const response = await fetch(url, {headers: encrypted.headers, credentials: 'same-origin', redirect: 'error'});
const result = await encrypted.decode(response);

成功响应

HTTP200,Cache-Control:no-store,外层JWE。以下仅截取目录条目,实际返回完整目录。

{"code":"SUCCESS","message":"操作成功。","data":{"countries":[{"id":"ad","aliases":["安道尔","Andorra","アンドラ","안도라","Andorra"]}],"languages":[{"id":"zh","native":"中文 / 汉语","symbol":"中"}],"interests":[{"id":"friends","tags":["meet","chat"]}]},"errors":[]}
字段 类型 可空 说明
countries object[] 否 249个国家/地区
countries[].id string 否 小写2位代码
countries[].aliases string[] 否 中英日韩与检索别名
languages object[] 否 10种语言
languages[].id string 否 语言代码
languages[].native string 否 原生语言名称
languages[].symbol string 否 展示标识
interests object[] 否 旧6类,最多原108项中的当前可选代码;新增项通过完整兴趣管理目录获取
interests[].id string 否 分类代码
interests[].tags string[] 否 旧标签代码;当前旧资料选择器资源映射保留,新接入使用完整兴趣目录

失败响应

400表示公共头、JWE或请求格式不合法;401表示Cookie失效或安装不匹配;403为权限/来源拒绝;426为HTTPS_REQUIRED;429为入口限流;503为依赖不可用。四语协议与后台安全一致,code不翻译。

{"code":"UNAUTHORIZED","message":"请先登录。","data":null,"errors":[]}

接入说明

语言字段保留原id/native/symbol结构,与App独立资料语言目录和资料保存校验共用同一份服务端配置;本后台接口不增加完整四语名称字段,也不提供动态增删语言的管理动作。

完整标签元数据及维护见兴趣管理目录,包括后台新增分类/标签、四语名称及图标。此旧协议保持原分组,不返回新建代码,避免旧客户端资源映射失败。

目录来自同一catalog模块,后台不复制国家/兴趣验证逻辑。不返回密码、用户资料或本机路径。服务器隔离PostgreSQL/Redis回归已验证真实JWE、Cookie及只读权限,返回249国家、10语言和6类兴趣;包含并行国家目录改动的完整整合272项通过。已随整合版本部署且278项服务器回归通过;后台网页资料选择器尚未接入,实际页面验收范围不包含选择器。