POST
/auth/queryPermissionList管理后台权限-列表查询
平台与系统 / 登录鉴权
基本信息
- 接口状态前端在用
- 接口URLPOST
https://dscp-dev.hn12301.net/manage-api/auth/queryPermissionList - 请求方式
POST - 暴露渠道管理后台 前缀
/manage-api - 名称来源源码注释
- 调用方已确认在用 · 管理后台（1 个前端）
- 需求上下文
- 维护人 / 最后改动AsiQue 2023-11-27
- 读写数据表
system_user、system_user_role、system_role、system_role_menu、system_menu反查该表全部接口 → - 控制器
com.jxxx.dscp.api.controller.auth.AuthController#queryPermissionList - 源码位置
jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/auth/AuthController.java:896 - 判定依据
请求参数
Header 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无（渠道统一鉴权头见《认证方式》） | ||||
Query 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
路径参数及说明
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
Body 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
认证方式
响应参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| user | … | 否 | UserSimpleResponse | 登录用户信息 |
| id | … | 否 | Long | 用户ID → system_user_role.id |
| nickname | … | 否 | String | 用户昵称 → system_user.nickname |
| remark | … | 否 | String | 备注 → system_user.remark |
| deptId | … | 否 | Long | 部门ID |
| postIds | … | 否 | List<Long> | 岗位编号数组 |
| … | 否 | String | 用户邮箱 → system_user.email | |
| mobile | … | 否 | String | 手机号码 → system_user.mobile |
| sex | … | 否 | Integer | 用户性别 → system_user.sex |
| avatar | … | 否 | String | 头像地址 → system_user.avatar |
| merchantId | … | 否 | Long | 商户id → system_user_role.merchant_id |
| shopId | … | 否 | Long | 商铺id → system_user_role.shop_id |
| tenantId | … | 否 | Long | 租户编号 → system_user_role.tenant_id |
| privilegeType | … | 否 | UserPrivilegeType | 用户权限类型 2＝平台用户 10＝商户 11＝商铺 |
| roles | … | 否 | List<String> | 角色标识列表 |
| permissions | … | 否 | List<String> | 操作权限数据 |
| menus | … | 否 | List<MenuResponse> | 菜单列表 |
| id | … | 否 | Long | 菜单ID → system_user_role.id |
| name | … | 否 | String | 菜单名称 → system_menu.name |
| permission | … | 否 | String | 权限标识 → system_menu.permission |
| type | … | 否 | MenuType | 菜单类型 → system_menu.type 1＝目录 2＝菜单 3＝按钮 |
| sort | … | 否 | Integer | 显示顺序 → system_menu.sort |
| parentId | … | 否 | Long | 父菜单ID → system_menu.parent_id |
| path | … | 否 | String | 路由地址 → system_menu.path |
| icon | … | 否 | String | 菜单图标 → system_menu.icon |
| component | … | 否 | String | 组件路径 → system_menu.component |
| componentName | … | 否 | String | 组件名 → system_menu.component_name |
| isEnabled | … | 否 | Boolean | 菜单状态 → system_menu.is_enabled |
| visible | … | 否 | Boolean | 是否可见 → system_menu.visible |
| keepAlive | … | 否 | Boolean | 是否缓存 → system_menu.keep_alive |
| alwaysShow | … | 否 | Boolean | 是否总是显示 → system_menu.always_show |
| children | … | 否 | List<MenuResponse> | 子列表 |
响应示例
成功响应示例
{
"errcode": 0,
"errmsg": "",
"data": {
"user": "…",
"id": "1",
"nickname": "\"string\"",
"remark": "\"string\"",
"deptId": "1",
"postIds": "[]",
"email": "\"string\"",
"mobile": "\"string\"",
"sex": "1",
"avatar": "\"string\"",
"merchantId": "1",
"shopId": "1"
}
}附录 · 实现细节
调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表：system_user、system_user_role、system_role、system_role_menu、system_menu 反查全部引用接口 →
- AuthController#queryPermissionList
- BeanUtils.map → UserSimpleResponse
其它依赖：UserService.mustGet、SessionUserService.getSessionId、SessionUserService.getSessionUser
逻辑摘要：调用 mustGet（userService.mustGet）；查询详情（sessionService.getSessionId）；列表查询（userRoleService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射
源码内联注释（旧站解析结果）
- 1.1 获得用户信息
- 1.2 获得角色列表
- 1.3 获得菜单列表
- 2. 拼接结果返回
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
dscp-html-manage/src/api/login/index.ts:37管理后台 · request