Skip to content

获取当前用户应用菜单授权

POST/sys_base/public/auth/getAppMenuAuthority
构建时间2026-06-26 20:10:33(Asia/Shanghai)来源项目中间件文档 / 中间件后端来源仓../cl-midserver-2026来源提交号69b951a07311e75887b57e0400d888f89dd72cac
查看文档来源信息
  • 来源目录:addons/sys_base/docs
  • 来源文件:接口文档/获取当前用户应用菜单授权.md

详细说明

移动端或应用端在已登录后,通过当前 token、Header app-id 和 Header addons-type 获取当前用户在当前应用下可用的 app_menu 页面、动作和菜单树。

接口会先复用系统 token 校验、会话校验和当前上下文校验,再按当前应用匹配已发布 app_menu。返回结果只包含当前角色已授权的移动端菜单权限;未发布或未授权时返回空权限,不回退到 PCWEB system_menu 授权。

接口信息

项目内容
请求方式POST
请求路径/sys_base/public/auth/getAppMenuAuthority
来源文件接口文档/获取当前用户应用菜单授权.md

请求头

请求头示例值说明
Content-Typeapplication/json请求体格式。
X-App-Key<temp-key>请按正式调用约定传入。
app-idAPP_UUID_001当前应用 ID。
addons-typetake_away当前模块标识。

入参

json
{
  "token": "<jwt token>"
}

参数说明

参数类型必填说明
tokenstring当前用户系统 token

请求示例

当前文档未提供独立请求示例,请参考下方 curl 示例。

响应输出

json
{
  "code": 0,
  "data": {
    "published": true,
    "addonsType": "take_away",
    "appUuid": "APP_UUID_001",
    "appId": "wx123456",
    "authorityId": 20,
    "accessMode": "role",
    "isSuperAdminContext": false,
    "appScopeKey": "scopeMode=app_uuids|appModelUuids=|appUuids=APP_UUID_001|appIds=",
    "appScope": {
      "scopeMode": "app_uuids",
      "appUuids": ["APP_UUID_001"]
    },
    "catalogVersion": "2026.06.10",
    "sourceProjectCode": "take_away",
    "versionUuid": "MENU_CATALOG_VERSION_xxx",
    "resolveNote": "已按当前 app-id 命中已发布 app_menu,并返回当前角色的移动端授权结果。",
    "defaultPage": {
      "pageCode": "take_away.app.home",
      "routeName": "takeAwayAppHome",
      "menuFlag": "take_away.app.home"
    },
    "manifestDefaultPage": {
      "pageCode": "take_away.app.home",
      "routeName": "takeAwayAppHome",
      "menuFlag": "take_away.app.home"
    },
    "pageCodes": ["take_away.app.home"],
    "actionCodes": ["take_away.app.home.view"],
    "menuFlags": ["take_away.app.home", "take_away.app.home.view"],
    "list": [],
    "tree": []
  },
  "msg": "获取应用菜单授权成功"
}

字段说明

字段说明
data.published当前应用是否命中已发布 app_menu
data.appScopeKey命中的发布应用范围键
data.appScope命中的发布应用范围
data.defaultPage当前角色在命中应用范围下配置的应用端默认首页;必须属于当前授权结果,无有效配置时为空
data.manifestDefaultPage命中 app_menu 清单声明的默认页,仅供应用了解清单原始默认落点
data.pageCodes当前用户已授权应用页面编码
data.actionCodes当前用户已授权应用动作编码
data.menuFlags当前用户已授权应用菜单标识和动作授权标识
data.list当前用户已授权页面及其已授权动作
data.tree已按授权结果过滤后的应用菜单树

curl 示例

bash
curl --location --request POST 'http://127.0.0.1:8100/sys_base/public/auth/getAppMenuAuthority' \
  --header 'Content-Type: application/json' \
  --header 'X-App-Key: <temp-key>' \
  --header 'app-id: APP_UUID_001' \
  --header 'addons-type: take_away' \
  --data-raw '{
    "token": "<jwt token>"
  }'

CL 正式文档平台