获取安装授权使用的启用角色组(addon.manage)
/api/v1/roles
GET
/api/v1/roles调用说明
仅返回启用角色。is_admin=true 的内置管理员始终可访问,无需加入页面白名单;调用者必须拥有 addon.manage。
Axios 请求示例
在已登录后台页面中调用;示例角色 ID 仅用于说明,请替换为当前系统中的实际角色。
javascript
axios.get('/api/v1/roles');响应结构示例
以下为结构示例,不是实时接口结果;列表和文档对象可能省略部分项目。
json
{
"code": 0,
"message": "操作成功",
"data": {
"list": [
{
"id": 1,
"name": "管理员",
"code": "super_admin",
"is_admin": true
},
{
"id": 3,
"name": "运营组",
"code": "operator",
"is_admin": false
}
]
}
}响应状态
| HTTP 状态 | 含义 |
|---|---|
| 200 | 成功 |
| 401 | 未登录或会话失效 |
| 403 | 没有权限 |
| 419 | CSRF 令牌无效 |
| 422 | 参数错误 |
| 503 | 数据库结构需要升级 |