跳到正文
SSaleSass开发者文档
管理后台
文档中心接口文档
接口文档

获取安装授权使用的启用角色组(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没有权限
419CSRF 令牌无效
422参数错误
503数据库结构需要升级
SaleSass 开发者文档 · 与项目内的接口契约同步