全部权限列表

HTTP Request

GET /api/admin/permissions

HEADERS

字段名 是否必填 描述
ACCESS-TOKEN true 授权token（aPaas提供）

URL Parameters

字段名 必填 描述

返回数据

{
    "code": 0,
    "message": "success",
    "remark": "成功",
    "data": {
        "models": [
            {
                "id": 10,
                "subject": "hall", // 主题
                "subject_title": "展馆管理",  // 主题名
                "controller": "hall",  // 分类
                "action": "down",  // 动作
                "name": "下架展馆" 
            },
            {
                "id": 9,
                "subject": "hall",
                "subject_title": "展馆管理",
                "controller": "hall",
                "action": "up",
                "name": "上架展馆"
            },
            {
                "id": 8,
                "subject": "hall",
                "subject_title": "展馆管理",
                "controller": "hall",
                "action": "edit",
                "name": "编辑展馆"
            },
            {
                "id": 7,
                "subject": "hall",
                "subject_title": "展馆管理",
                "controller": "hall",
                "action": "create",
                "name": "新增展馆"
            },
            {
                "id": 6,
                "subject": "hall",
                "subject_title": "展馆管理",
                "controller": "hall",
                "action": "show",
                "name": "查看展馆"
            }
        ]
    }
}

全部权限列表

HTTP Request

GET /api/admin/roles

HEADERS

字段名 是否必填 描述
ACCESS-TOKEN true 授权token（aPaas提供）

URL Parameters

字段名 必填 描述

返回数据

{
    "code": 0,
    "message": "success",
    "remark": "成功",
    "data": {
        "total_count": 2,
        "total_pages": 1,
        "next_page": null,
        "prev_page": null,
        "current_page": 1,
        "per_page": 15,
        "page": 1,
        "models": [
            {
                "id": 2,
                "name": "系统管理员", // 角色名
                "created_at": "2024-07-31T10:45:59.155+08:00",
                "updated_at": "2024-07-31T10:45:59.155+08:00",
                "default_role": true, // 是否系统默认角色
                "permissions": [ // 权限列表
                    {
                        "id": 6,
                        "subject": "hall",
                        "subject_title": "展馆管理",
                        "controller": "hall",
                        "action": "show",
                        "name": "查看展馆"
                    },
                    {
                        "id": 7,
                        "subject": "hall",
                        "subject_title": "展馆管理",
                        "controller": "hall",
                        "action": "create",
                        "name": "新增展馆"
                    },
                    {
                        "id": 8,
                        "subject": "hall",
                        "subject_title": "展馆管理",
                        "controller": "hall",
                        "action": "edit",
                        "name": "编辑展馆"
                    },
                    {
                        "id": 9,
                        "subject": "hall",
                        "subject_title": "展馆管理",
                        "controller": "hall",
                        "action": "up",
                        "name": "上架展馆"
                    },
                    {
                        "id": 10,
                        "subject": "hall",
                        "subject_title": "展馆管理",
                        "controller": "hall",
                        "action": "down",
                        "name": "下架展馆"
                    }
                ]
            },
            {
                "id": 1,
                "name": "test",
                "created_at": "2024-07-30T23:06:25.077+08:00",
                "updated_at": "2024-07-30T23:10:59.408+08:00",
                "default_role": false,
                "permissions": []
            }
        ]
    }
}

创建角色

HTTP Request

POST /api/admin/roles

HEADERS

字段名 是否必填 描述
ACCESS-TOKEN true 授权token（aPaas提供）

URL Parameters

字段名 必填 描述

Body Parameters

字段名 是否必填 描述
admin_role 是 任务信息

请求正文

{
    "admin_role": {
        "name":  "xxxx", // 角色名
        "permission_ids": [1,2] // 权限列表
    }
}

返回数据

{
    "code": 0,
    "message": "success",
    "remark": "成功",
    "data": {
        "id": 5,
        "name": "test",
        "created_at": "2024-08-04T00:03:15.741+08:00",
        "updated_at": "2024-08-04T00:03:15.741+08:00",
        "default_role": false,
        "permissions": [
            {
                "id": 6,
                "subject": "hall",
                "subject_title": "展馆管理",
                "controller": "hall",
                "action": "show",
                "name": "查看展馆"
            },
            {
                "id": 7,
                "subject": "hall",
                "subject_title": "展馆管理",
                "controller": "hall",
                "action": "create",
                "name": "新增展馆"
            },
            {
                "id": 8,
                "subject": "hall",
                "subject_title": "展馆管理",
                "controller": "hall",
                "action": "edit",
                "name": "编辑展馆"
            }
        ]
    }
}

角色详情

HTTP Request

GET /api/admin/roles/:id

HEADERS

字段名 是否必填 描述
ACCESS-TOKEN true 授权token（aPaas提供）

URL Parameters

字段名 必填 描述
id 是 角色ID

Body Parameters

字段名 是否必填 描述

请求正文

{
    "code": 0,
    "message": "success",
    "remark": "成功",
    "data": {
        "id": 5,
        "name": "test",
        "created_at": "2024-08-04T00:03:15.741+08:00",
        "updated_at": "2024-08-04T00:03:15.741+08:00",
        "default_role": false,
        "permissions": [
            {
                "id": 6,
                "subject": "hall",
                "subject_title": "展馆管理",
                "controller": "hall",
                "action": "show",
                "name": "查看展馆"
            },
            {
                "id": 7,
                "subject": "hall",
                "subject_title": "展馆管理",
                "controller": "hall",
                "action": "create",
                "name": "新增展馆"
            },
            {
                "id": 8,
                "subject": "hall",
                "subject_title": "展馆管理",
                "controller": "hall",
                "action": "edit",
                "name": "编辑展馆"
            }
        ]
    }
}

更新角色

HTTP Request

PUT /api/admin/roles/:id

HEADERS

字段名 是否必填 描述
ACCESS-TOKEN true 授权token（aPaas提供）

URL Parameters

字段名 必填 描述
id 是 角色ID

Body Parameters

字段名 是否必填 描述
admin_role 是 任务信息

请求正文

{
    "admin_role": {
        "name":  "xxxx", // 角色名
        "permission_ids": [1,2] // 权限列表
    }
}

返回数据

{
    "code": 0,
    "message": "success",
    "remark": "成功",
    "data": {
        "id": 5,
        "name": "test",
        "created_at": "2024-08-04T00:03:15.741+08:00",
        "updated_at": "2024-08-04T00:03:15.741+08:00",
        "default_role": false,
        "permissions": [
            {
                "id": 6,
                "subject": "hall",
                "subject_title": "展馆管理",
                "controller": "hall",
                "action": "show",
                "name": "查看展馆"
            },
            {
                "id": 7,
                "subject": "hall",
                "subject_title": "展馆管理",
                "controller": "hall",
                "action": "create",
                "name": "新增展馆"
            },
            {
                "id": 8,
                "subject": "hall",
                "subject_title": "展馆管理",
                "controller": "hall",
                "action": "edit",
                "name": "编辑展馆"
            }
        ]
    }
}

删除角色

HTTP Request

DELETE /api/admin/roles/:id

HEADERS

字段名 是否必填 描述
ACCESS-TOKEN true 授权token（aPaas提供）

URL Parameters

字段名 必填 描述
id 是 角色ID

Body Parameters

字段名 是否必填 描述

返回数据

{
    "code": 0,
    "message": "success",
    "remark": "成功"
}
文档更新时间: 2025-04-09 17:20   作者：李辉