1. 认证授权角色治理控制器
Encounter-Freedom
  • ef-auth
    • actuator
      • 获取全部方法
      • 模块详情
      • 获取全部组件健康状态
      • 获取指定类型组件状态
    • 测试 nacos 配置
      • test
      • test
    • 统一错误出口(Servlet || Spring MVC 场景)
      • 统一错误处理入口
    • 认证用户表(全局账号)(ef_auth_user) 表控制层
      • 通过用户ID获取用户信息
    • 当前登录用户查询接口
      • 获取当前登录用户权限
      • 获取当前登录用户在主体应用中的动态导航树
      • 获取当前登录用户在一个稳定路由中可显示的前端动作
    • OAuth 风格客户端令牌接口
      • 申请客户端 Access Token
    • JWK Set 公开接口
      • 返回标准格式的 JWK Set JSON
    • 对外暴露当前服务的构建信息
      • 返回当前服务的构建信息
    • 邮件接口
      • 向邮箱发送验证码
    • 文件上传控制器(对象存储预签名直传)
      • 申请预签名上传
      • 提交上传确认
      • 清理未被业务采用的临时对象
    • 登录与会话接口控制器
      • 注册
      • 登录
      • 刷新 Access Token
      • 退出登录
    • 认证授权应用治理控制器
      • 分页查询认证授权应用
      • 查询单个认证授权应用
      • 注册新的认证授权应用
      • 修改应用名称和说明
      • 启用或停用普通应用
    • 动态菜单统一管理控制器
      • 查询指定导航应用的完整菜单管理树
      • 创建动态菜单及其权限条件
      • 修改菜单展示定义、父子关系和权限条件
      • 原子调整同级菜单顺序
      • 修改菜单显示与启用状态
      • 删除没有有效子节点的菜单(逻辑删除)
    • 认证授权角色治理控制器
      • 分页查询指定主体应用下的角色
        GET
      • 查询单个角色
        GET
      • 创建普通角色
        POST
      • 修改角色资料
        PUT
      • 变更角色启用状态
        PATCH
      • 删除没有关系引用的普通角色
        DELETE
      • 查询角色当前完整权限集合
        GET
      • 原子替换角色当前完整权限集合
        PUT
      • 预览角色授权双模式的最终权限集合与增减明细
        POST
    • 认证用户内部查询控制器
      • 获取用户信息
      • 通过电子邮件获取用户信息
    • 机器客户端治理控制器
      • 分页查询机器客户端
      • 查询机器客户端详情
      • 创建机器客户端并一次性返回明文密钥
      • 修改机器客户端显示资料
      • 启用或停用机器客户端
      • 轮换机器客户端密钥
      • 删除普通机器客户端
      • 查询机器客户端完整 Scope 集合
      • 原子替换机器客户端完整 Scope 集合
      • 查询机器客户端完整权限集合
      • 原子替换机器客户端完整权限集合
    • 权限治理审计日志查询控制器
      • 分页查询权限治理审计日志
      • 查询审计操作者昵称候选,供管理端 Vben 下拉筛选使用
    • 用户角色授权治理控制器
      • 查询用户在指定主体应用下的完整角色集合
      • 原子替换用户在一个主体应用下的完整角色集合
    • 正式权限定义管理控制器
      • 分页查询正式权限定义
      • 查询单个正式权限定义
      • 新增手工维护的权限定义
      • 修改手工维护的权限定义
      • 变更非系统权限的生命周期状态
      • 删除未被引用的手工权限定义
    • 认证授权用户治理控制器
      • 分页查询用户账号
      • 创建用户账号
      • 查询单个用户账号详情
      • 修改用户账号展示资料
      • 逻辑删除用户账号及其成员关系
      • 修改用户账号状态
      • 修改用户账号
      • 创建用户账号成员关系
      • 删除用户账号成员关系
    • 授权发现任务管理控制器
      • 创建并异步执行手动授权发现任务
      • 查询单个授权发现任务
      • 分页查询授权发现任务历史
      • 分页查询权限发现候选
      • 分页查询菜单发现候选
      • 接受或忽略权限候选
      • 接受或忽略菜单候选
      • 批量接受或忽略权限候选
      • 批量接受或忽略菜单候选
    • 正式授权目录发布管理控制器
      • 查询正式授权目录当前版本
      • 查询单个授权目录发布批次
      • 分页查询授权目录发布历史
      • 原子发布一组已接受的权限和菜单候选
    • 前端授权清单上传控制器
      • 上传并接收管理端前端完整授权清单
    • 动态 Feign 清单端点契约
      • 查询目标模块当前运行时完整授权清单
    • 数据模型
      • RestResponse«Void»
      • UserInfoVO
      • PermissionUsageDeclaration
      • RestResponse«List«UserInfoVO»»
      • PermissionDeclaration
      • RestResponse«UserInfoVO»
      • MenuDeclaration
      • ClientTokenResponse
      • FrontendActionDeclaration
      • RestResponse«ClientTokenResponse»
      • AuthorizationModuleManifest
      • ClientTokenRequest
      • RestResponse«AuthorizationModuleManifest»
      • ResponseEntity«RestResponse«Void»»
      • BuildVersionVO
      • RestResponse«BuildVersionVO»
      • TagVO
      • RestResponse<T>
      • RestResponse«List«TagVO»»
      • NoticeVO
      • RestResponse«NoticeVO»
      • SimpleTagVO
      • ArticleVO
      • PageResult«ArticleVO»
      • RestResponse«PageResult«ArticleVO»»
      • TagInfoVO
      • ArticleDetailVO
      • RestResponse«ArticleArchiveIndexVO»
      • RestResponse«ArticleDetailVO»
      • RestResponse«Boolean»
      • ArticleAccessDTO
      • SimpleArticleVO
      • ArticleNeighborVO
      • RestResponse«ArticleNeighborVO»
      • ArticleMonthVO
      • ArticleArchiveIndexVO
      • RestResponse«List«ArticleArchiveIndexVO»»
      • ArchiveVO
      • RestResponse«List«ArchiveVO»»
      • CommentUserInfo
      • CommentVO
      • RestResponse«List«CommentVO»»
      • CommentPublishVO
      • RestResponse«CommentPublishVO»
      • CommentPublishDTO
      • CommentPageQueryVO
      • PageResult«CommentPageQueryVO»
      • RestResponse«PageResult«CommentPageQueryVO»»
      • CategoryVO
      • RestResponse«List«CategoryVO»»
      • RestResponse«List«String»»
      • RestResponse«String»
      • SiteStatsVO
      • RestResponse«SiteStatsVO»
      • Map«Object»
      • RestResponse«CurrentPermissionVO»
      • Token
      • CurrentPermissionVO
      • Me
      • Roles
      • LoginVO
      • NavigationMenuVO
      • NavigationVO
      • RestResponse«NavigationVO»
      • RestResponse«Token»
      • FrontendActionAvailabilityVO
      • RestResponse«FrontendActionAvailabilityVO»
      • EmailCodeSendDTO
      • FilePresignVO
      • RestResponse«FilePresignVO»
      • FilePresignDTO
      • FileCommitVO
      • RestResponse«FileCommitVO»
      • Map«String»
      • FileCommitDTO
      • RegisterDTO
      • RestResponse«LoginVO»
      • LoginDTO
      • ApplicationVO
      • PageResult«ApplicationVO»
      • RestResponse«PageResult«ApplicationVO»»
      • RestResponse«ApplicationVO»
      • ApplicationCreateDTO
      • ApplicationUpdateDTO
      • ApplicationStatusDTO
      • MenuVO
      • RestResponse«List«MenuVO»»
      • RestResponse«MenuVO»
      • MenuCreateDTO
      • MenuUpdateDTO
      • Item
      • MenuReorderDTO
      • MenuStatusDTO
      • RoleVO
      • PageResult«RoleVO»
      • RestResponse«PageResult«RoleVO»»
      • RestResponse«RoleVO»
      • RoleCreateDTO
      • RoleUpdateDTO
      • RoleStatusDTO
      • PermissionVO
      • RolePermissionVO
      • RestResponse«RolePermissionVO»
      • RolePermissionReplaceDTO
      • PermissionBriefVO
      • RolePermissionPreviewVO
      • RestResponse«RolePermissionPreviewVO»
      • RolePermissionPreviewDTO
      • AuthUser
      • RestResponse«List«AuthUser»»
      • RestResponse«AuthUser»
      • ClientVO
      • PageResult«ClientVO»
      • RestResponse«PageResult«ClientVO»»
      • ClientGrantedPermissionVO
      • ClientDetailVO
      • RestResponse«ClientDetailVO»
      • ClientSecretVO
      • RestResponse«ClientSecretVO»
      • ClientCreateDTO
      • RestResponse«ClientVO»
      • ClientUpdateDTO
      • ClientStatusDTO
      • ClientSecretRotateDTO
      • ClientScopeSetVO
      • RestResponse«ClientScopeSetVO»
      • ClientScopeReplaceDTO
      • ClientPermissionSetVO
      • RestResponse«ClientPermissionSetVO»
      • ClientPermissionReplaceDTO
      • AuditLogVO
      • PageResult«AuditLogVO»
      • RestResponse«PageResult«AuditLogVO»»
      • AuditOperatorOptionVO
      • RestResponse«List«AuditOperatorOptionVO»»
      • UserRoleVO
      • RestResponse«UserRoleVO»
      • UserRoleReplaceDTO
      • PageResult«PermissionVO»
      • RestResponse«PageResult«PermissionVO»»
      • RestResponse«PermissionVO»
      • PermissionCreateDTO
      • PermissionUpdateDTO
      • PermissionStatusDTO
      • SubjectAppBrief
      • UserPageVO
      • PageResult«UserPageVO»
      • RestResponse«PageResult«UserPageVO»»
      • UserRole
      • SubjectApp
      • UserManageVO
      • RestResponse«UserManageVO»
      • SubjectAppDTO
      • UserCreateDTO
      • UserUpdateDTO
      • UserUpdateMemberShipsDTO
      • UserDeleteMemberShipsDTO
      • DiscoveryJobVO
      • RestResponse«DiscoveryJobVO»
      • DiscoveryStartDTO
      • PageResult«DiscoveryJobVO»
      • RestResponse«PageResult«DiscoveryJobVO»»
      • PermissionDiscoveryVO
      • PageResult«PermissionDiscoveryVO»
      • RestResponse«PageResult«PermissionDiscoveryVO»»
      • MenuDiscoveryVO
      • PageResult«MenuDiscoveryVO»
      • RestResponse«PageResult«MenuDiscoveryVO»»
      • RestResponse«PermissionDiscoveryVO»
      • CandidateReviewDTO
      • RestResponse«MenuDiscoveryVO»
      • CandidateBatchReviewDTO
      • CatalogRevisionVO
      • RestResponse«CatalogRevisionVO»
      • PublicationVO
      • RestResponse«PublicationVO»
      • PageResult«PublicationVO»
      • RestResponse«PageResult«PublicationVO»»
      • PublicationCreateDTO
      • ManifestUploadVO
      • RestResponse«ManifestUploadVO»
  • ef-blog
    • actuator
      • 获取全部方法
      • 模块详情
      • 获取全部组件健康状态
      • 获取指定类型组件状态
    • 统一错误出口(Servlet || Spring MVC 场景)
      • 统一错误处理入口
    • 站点配置表(ef_blog_site_config)表控制层
      • 获取站点配置
      • 获取站点统计
    • 博客公告表(ef_blog_notice)表控制层
      • 获取最新的公告
    • 博客背景图表(ef_blog_background)表控制层
      • 获取所有背景图URL
    • 博客文章表(ef_blog_article)表控制层
      • 分页查询文章列表
      • 获取文章详情
      • 验证文章访问密码
      • 获取文章的上一篇/下一篇
      • 获取文章归档列表
      • 根据年/月获取归档文章
    • 博客分类表控制层
      • 查看所有分类
    • 博客标签表控制层
      • 获取热门标签(默认20条)
      • 获取所有标签
    • 博客评论接口
      • 获取最新评论
      • 发布评论
      • 获取文章评论树
    • 对外暴露当前服务的构建信息
      • 返回当前服务的构建信息
    • 数据模型
      • RestResponse«Void»
      • UserInfoVO
      • PermissionUsageDeclaration
      • RestResponse«List«UserInfoVO»»
      • PermissionDeclaration
      • RestResponse«UserInfoVO»
      • MenuDeclaration
      • ClientTokenResponse
      • FrontendActionDeclaration
      • RestResponse«ClientTokenResponse»
      • AuthorizationModuleManifest
      • ClientTokenRequest
      • RestResponse«AuthorizationModuleManifest»
      • ResponseEntity«RestResponse«Void»»
      • RestResponse<T>
      • BuildVersionVO
      • RestResponse«BuildVersionVO»
      • TagVO
      • RestResponse«List«TagVO»»
      • NoticeVO
      • RestResponse«NoticeVO»
      • SimpleTagVO
      • ArticleVO
      • PageResult«ArticleVO»
      • RestResponse«PageResult«ArticleVO»»
      • TagInfoVO
      • ArticleDetailVO
      • RestResponse«ArticleArchiveIndexVO»
      • RestResponse«ArticleDetailVO»
      • RestResponse«Boolean»
      • ArticleAccessDTO
      • SimpleArticleVO
      • ArticleNeighborVO
      • RestResponse«ArticleNeighborVO»
      • ArticleMonthVO
      • ArticleArchiveIndexVO
      • RestResponse«List«ArticleArchiveIndexVO»»
      • ArchiveVO
      • RestResponse«List«ArchiveVO»»
      • CommentUserInfo
      • CommentVO
      • RestResponse«List«CommentVO»»
      • CommentPublishVO
      • RestResponse«CommentPublishVO»
      • CommentPublishDTO
      • CommentPageQueryVO
      • PageResult«CommentPageQueryVO»
      • RestResponse«PageResult«CommentPageQueryVO»»
      • CategoryVO
      • RestResponse«List«CategoryVO»»
      • RestResponse«List«String»»
      • RestResponse«String»
      • SiteStatsVO
      • RestResponse«SiteStatsVO»
  • ef-gateway
    • actuator
      • 获取全部方法
      • 模块详情
      • 获取全部组件健康状态
      • 获取指定类型组件状态
    • 反向代理入口 Controller(网关核心入口)
      • 网关统一转发入口
    • 网关统一错误出口
      • 错误出口入口方法
    • 对外暴露当前服务的构建信息
      • 返回当前服务的构建信息
    • 数据模型
      • RestResponse«Void»
      • UserInfoVO
      • PermissionUsageDeclaration
      • RestResponse«List«UserInfoVO»»
      • PermissionDeclaration
      • RestResponse«UserInfoVO»
      • MenuDeclaration
      • ClientTokenResponse
      • FrontendActionDeclaration
      • RestResponse«ClientTokenResponse»
      • AuthorizationModuleManifest
      • ClientTokenRequest
      • RestResponse«AuthorizationModuleManifest»
      • ResponseEntity«RestResponse«Void»»
      • BuildVersionVO
      • RestResponse«BuildVersionVO»
      • RestResponse<T>
  • ef-framework
    • TestController
      • publicPing
      • privatePing
    • Auth 服务 Feign 契约
      • 批量根据用户 ID 获取用户资料
      • 根据用户 ID 获取单个用户资料
      • 根据邮箱获取用户资料
      • 批量根据用户 ID 获取用户资料
      • 根据用户 ID 获取单个用户资料
      • 根据邮箱获取用户资料
    • CacheClient
      • 构建缓存键
      • 获取缓存并转换类型
      • 获取列表缓存并转换为指定元素类型
      • 设置缓存(默认过期时间)
      • 设置缓存(自定义过期时间)
      • 设置缓存(自定义过期时间,指定时间单位)
      • 设置空值缓存(防穿透)
      • 根据缓存键删除缓存
      • CacheClient
    • Auth 令牌接口 Feign 客户端
      • 申请客户端令牌
      • 申请客户端令牌
    • SecurityResponseController
      • unauthorized
      • forbidden
    • 服务端运行时授权清单内部接口
      • 返回当前服务实例的完整运行时授权清单
    • 数据模型
      • RestResponse«Void»
      • UserInfoVO
      • PermissionUsageDeclaration
      • RestResponse«List«UserInfoVO»»
      • PermissionDeclaration
      • RestResponse«UserInfoVO»
      • MenuDeclaration
      • ClientTokenResponse
      • FrontendActionDeclaration
      • RestResponse«ClientTokenResponse»
      • AuthorizationModuleManifest
      • ClientTokenRequest
      • RestResponse«AuthorizationModuleManifest»
  1. 认证授权角色治理控制器

原子替换角色当前完整权限集合

PUT
/roles/{roleId}/permissions

请求参数

Path 参数

Query 参数

Body 参数application/json

示例
{
    "explicitIds": [
        0
    ],
    "menuIds": [
        0
    ],
    "version": 1,
    "reason": "string"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'http://localhost:1111/api/v1/auth/roles//permissions' \
--header 'Content-Type: application/json' \
--data '{
    "explicitIds": [
        0
    ],
    "menuIds": [
        0
    ],
    "version": 1,
    "reason": "string"
}'

返回响应

🟢200
application/json
Bodyapplication/json

示例
{
    "code": 0,
    "message": "string",
    "messageKey": "string",
    "timestamp": 0,
    "data": {
        "role": {
            "id": 0,
            "subjectAppId": 0,
            "subjectAppCode": "string",
            "subjectAppName": "string",
            "roleCode": "string",
            "roleName": "string",
            "description": "string",
            "sortOrder": 0,
            "systemRole": true,
            "enabled": true,
            "version": 0,
            "permissionCount": 0,
            "userCount": 0,
            "createTime": "string",
            "updateTime": "string"
        },
        "permissions": [
            {
                "id": 0,
                "resourceAppId": 0,
                "resourceAppCode": "string",
                "resourceAppName": "string",
                "permCode": "string",
                "permName": "string",
                "description": "string",
                "origin": "MANIFEST",
                "status": "ACTIVE",
                "systemPermission": true,
                "version": 0,
                "createTime": "string",
                "updateTime": "string"
            }
        ],
        "authorizationVersion": 0
    },
    "requestId": "resolveRequestId()"
}
修改于 2026-10-10 16:58:11
上一页
查询角色当前完整权限集合
下一页
预览角色授权双模式的最终权限集合与增减明细
Built with