查询角色列表#

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

用途与场景#

按条件读取角色列表。

使用位置#

页面/功能	角色或空间分支
查询角色列表（XLSX 导出）	当前 $spaceId；按钮可见性与后端授权分别校验

端点#

POST /main-service/system-api/authority/role/list — 按条件读取角色列表。

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

动线与完成判据#

status=200 且 data 数组可消费表示读取结束；[] 是成功空结果。

错误与边界#

错误出口与四类映射见错误响应差异。读取可按网络策略重试。

调用关系与资源清理#

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

已知缺口#

角色复选组件没有发送 sqlQueryLimit，服务端按 100 条截断；租户角色超过 100 时当前 Web 可能无法展示全部角色。无已知关键缺口；未执行真实联调。