Appearance
功能概述
角色列表
- 会把所有的角色和角色下的权限节点打平返回
接口访问
接口地址
system/manage/role/list
请求方式 Method
GET
Header - Authorization Type : Bearer Token
| 属性 | 类型 | 长度 | 必填 | 默认值 | 说明 | 访问版本 |
|---|---|---|---|---|---|---|
| token | string | 32 | true | 用户身份标识令牌 | - |
返回值
| 属性 | 类型 | 必填 | 描述 |
|---|---|---|---|
| role_id | int | true | 角色ID |
| alias | string | true | 角色藐视 |
| name | string | true | 角色名称 |
| parent_role_id | int | true | 父级角色ID |
| parent_role_list | string | false | 父级角色链（暂时没用） |
| type | string | true | 角色类别 |
| group | string | true | 角色分组 |
| create_time | string | true | 角色创建时间 |
| modify_time | string | true | 角色更新时间 |
| role_detail | array | false | 角色权限详情 |
| role_detail[].permission_id | int | true | 权限ID |
| role_detail[].alias | string | true | 权限描述 |
| role_detail[].name | string | true | 权限名称 |
| role_detail[].method | string | true | 请求方式（暂时没用） |
| role_detail[].path | string | true | 权限路径（暂时没用） |
| role_detail[].permission_type | int | true | 权限类型，1菜单权限 |
| role_detail[].create_time | string | true | 权限创建时间 |
| role_detail[].modify_time | string | true | 权限更新时间 |
返回示例
{
"response": [
{
"role_id": 1,
"alias": "root",
"name": "系统",
"parent_role_id": 0,
"parent_role_list": "0",
"type": "ADMIN",
"group": "ROOT",
"create_time": "2025-07-24 15:11:29",
"modify_time": "2025-07-24 15:11:31",
"role_detail": [
{
"permission_id": 51,
"alias": "menu_51",
"name": "首页",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 52,
"alias": "menu_52",
"name": "用户管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 53,
"alias": "menu_53",
"name": "用户列表",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 54,
"alias": "menu_54",
"name": "角色管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 55,
"alias": "menu_55",
"name": "订单管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 56,
"alias": "menu_56",
"name": "硬件管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 57,
"alias": "menu_57",
"name": "硬件设备管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 58,
"alias": "menu_58",
"name": "水电表管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 59,
"alias": "menu_59",
"name": "智能门锁管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
}
]
},
{
"role_id": 2,
"alias": "agent",
"name": "代理",
"parent_role_id": 1,
"parent_role_list": "0",
"type": "ADMIN",
"group": "ADMIN",
"create_time": "2025-07-24 15:11:30",
"modify_time": "2025-10-21 11:24:59",
"role_detail": [
{
"permission_id": 51,
"alias": "menu_51",
"name": "首页",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 52,
"alias": "menu_52",
"name": "用户管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 53,
"alias": "menu_53",
"name": "用户列表",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 54,
"alias": "menu_54",
"name": "角色管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 55,
"alias": "menu_55",
"name": "订单管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 56,
"alias": "menu_56",
"name": "硬件管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 57,
"alias": "menu_57",
"name": "硬件设备管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 58,
"alias": "menu_58",
"name": "水电表管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 59,
"alias": "menu_59",
"name": "智能门锁管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
}
]
},
{
"role_id": 4,
"alias": "houseowner",
"name": "业主",
"parent_role_id": 1,
"parent_role_list": "0",
"type": "ADMIN",
"group": "ADMIN",
"create_time": "2025-10-20 16:13:49",
"modify_time": "2025-10-21 11:26:22",
"role_detail": [
{
"permission_id": 51,
"alias": "menu_51",
"name": "首页",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 52,
"alias": "menu_52",
"name": "用户管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 53,
"alias": "menu_53",
"name": "用户列表",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 54,
"alias": "menu_54",
"name": "角色管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 55,
"alias": "menu_55",
"name": "订单管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 56,
"alias": "menu_56",
"name": "硬件管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 57,
"alias": "menu_57",
"name": "硬件设备管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 58,
"alias": "menu_58",
"name": "水电表管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 59,
"alias": "menu_59",
"name": "智能门锁管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
}
]
},
{
"role_id": 5,
"alias": "tenant",
"name": "租客",
"parent_role_id": 1,
"parent_role_list": "0",
"type": "ADMIN",
"group": "ADMIN",
"create_time": "2025-10-20 16:13:51",
"modify_time": "2025-10-21 11:35:18",
"role_detail": [
{
"permission_id": 51,
"alias": "menu_51",
"name": "首页",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
},
{
"permission_id": 56,
"alias": "menu_56",
"name": "硬件管理",
"method": "ALL",
"path": "",
"permission_type": 1,
"create_time": "2025-10-20 18:52:24",
"modify_time": "2025-10-20 18:52:24"
}
]
}
],
"requestId": "b3a2ce37-2e4e-4a67-8ccf-e6c2dc7c2443"
}错误码
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| 404 | Fail | 代码报错 |