按 ID 读取角色及权限#

验证状态：已源码核验、未联调；适用基线：源码归纳 @ 2026-09-14

用途与场景#

按资源 ID 读取角色详情。

使用位置#

页面/功能	角色或空间分支
按 ID 读取角色及权限	当前 $spaceId；按钮可见性与后端授权分别校验

端点#

GET /main-service/system-api/authority/role/getById — 按资源 ID 读取角色详情。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 authority · role 角色；业务语义（wire 惯例、限频、租户声明等）见授权业务 · role 角色。

动线与完成判据#

status=200 且 data 为对象表示读取结束。详情组装会把基础记录复制到 Plus DTO；目标不存在没有被归一化为 或 data=null，调用方不能依赖缺失记录的响应形态。

错误与边界#

错误出口与四类映射见错误响应差异。不存在的角色可能在 Plus DTO 组装时落入未处理技术异常，当前源码未定义稳定的 not-found 合同。读取可按网络策略重试。

调用关系与资源清理#

无长连接资源；读取操作完成后无需客户端释放服务端资源。变更后的列表或详情需由调用方重新读取。

已知缺口#

无已知关键缺口；未执行真实联调。