4.1、权限列表1
1、请求地址
GET /auths
需进行token认证
用于列表页、新增页、修改页展示，返回 无限级分类 列表结构数据
示例： http://adminapi.tbyue.com/auths
2、请求参数
| 名称 | 类型 | 必填 | 备注 |
|---|---|---|---|
| keyword | string | 否 | 搜索关键字 |
3、返回数据
返回数据集[{},{},...]
| 名称 | 备注 |
|---|---|
| id | 权限id |
| auth_name | 权限名称 |
| pid | 父id |
| pid_path | 家族图谱（祖先id_父id）,示例：0_1_2 |
| auth_c | 控制器名称 |
| auth_a | 方法名称 |
| is_nav | 是否菜单权限 1是 0否 |
| level | 级别 0 1 2 3 ， 0为最顶级 |
4、返回示例
[
{
"id": 10,
"auth_name": "菜单管理",
"pid": 5,
"pid_path": "0_2_5",
"auth_c": "auth",
"auth_a": "index",
"is_nav": "1",
"level": 2
},
{
"id": 65,
"auth_name": "添加权限",
"pid": 10,
"pid_path": "0_2_5_10",
"auth_c": "auth",
"auth_a": "create",
"is_nav": "0",
"level": 3
}
]
4.2、权限列表2
1、请求地址
1、请求地址
GET /auths
需进行token认证
用于给角色分配权限，返回 父子级 树状结构数据
示例： http://adminapi.tbyue.com/auths
2、请求参数
| 名称 | 类型 | 必填 | 备注 |
|---|---|---|---|
| type | string | 是 | tree |
3、返回数据
返回数据集[{},{},...]
树状结构，每个权限中有son字段，包含其所有子权限
| 名称 | 备注 |
|---|---|
| id | 权限id |
| auth_name | 权限名称 |
| pid | 父id |
| pid_path | 家族图谱（祖先id_父id）,示例：0_1_2 |
| auth_c | 控制器名称 |
| auth_a | 方法名称 |
| is_nav | 是否菜单权限 1是 0否 |
| level | 级别 0 1 2 3 ， 0为最顶级 |
| son | 子权限数据集 |
4、返回示例
[
{
"id": 1,
"auth_name": "首页",
"pid": 0,
"pid_path": "0",
"auth_c": "",
"auth_a": "",
"is_nav": "是",
"level": 0,
"son": [
{
"id": 90,
"auth_name": "首页",
"pid": 1,
"pid_path": "0_1",
"auth_c": "",
"auth_a": "",
"is_nav": "是",
"level": 1,
"son": [
{
"id": 91,
"auth_name": "首页",
"pid": 90,
"pid_path": "0_1_90",
"auth_c": "index",
"auth_a": "index",
"is_nav": "是",
"level": 2,
"son": []
}
]
}
]
},
{
"id": 2,
"auth_name": "平台",
"pid": 0,
"pid_path": "0",
"auth_c": "",
"auth_a": "",
"is_nav": "是",
"level": 0,
"son": [
{
"id": 5,
"auth_name": "系统配置",
"pid": 2,
"pid_path": "0_2",
"auth_c": "",
"auth_a": "",
"is_nav": "是",
"level": 1,
"son": [
{
"id": 9,
"auth_name": "附件管理",
"pid": 5,
"pid_path": "0_2_5",
"auth_c": "",
"auth_a": "",
"is_nav": "是",
"level": 2,
"son": []
},
{
"id": 10,
"auth_name": "菜单管理",
"pid": 5,
"pid_path": "0_2_5",
"auth_c": "auth",
"auth_a": "index",
"is_nav": "是",
"level": 2,
"son": []
}
]
},
{
"id": 6,
"auth_name": "权限管理",
"pid": 2,
"pid_path": "0_2",
"auth_c": "",
"auth_a": "",
"is_nav": "是",
"level": 1,
"son": [
{
"id": 11,
"auth_name": "管理员管理",
"pid": 6,
"pid_path": "0_2_6",
"auth_c": "admin",
"auth_a": "index",
"is_nav": "是",
"level": 2,
"son": []
},
{
"id": 12,
"auth_name": "角色管理",
"pid": 6,
"pid_path": "0_2_6",
"auth_c": "role",
"auth_a": "index",
"is_nav": "是",
"level": 2,
"son": []
}
]
}
]
},
]
4.3、权限详情
1、请求地址
1、请求地址
GET /auths/[:id]
需进行token认证
[:id] 为权限id
示例： http://adminapi.tbyue.com/auths/1
2、请求参数
无
3、返回数据
| 名称 | 备注 |
|---|---|
| id | 权限id |
| auth_name | 权限名称 |
| pid | 父id |
| pid_path | 家族图谱（祖先id_父id）,示例：0_1_2 |
| auth_c | 控制器名称 |
| auth_a | 方法名称 |
| is_nav | 是否菜单权限 1是 0否 |
| level | 级别 0 1 2 3 ， 0为最顶级 |
4、返回示例
{
"id": 65,
"auth_name": "添加权限",
"pid": 10,
"pid_path": "0_2_5_10",
"auth_c": "auth",
"auth_a": "create",
"is_nav": 0,
"level": 3
}
4.4、权限新增
1、请求地址
1、请求地址
POST /auths
需进行token认证
示例： http://adminapi.tbyue.com/auths
2、请求参数
| 名称 | 类型 | 必填 | 备注 |
|---|---|---|---|
| auth_name | string | 是 | 权限名 |
| pid | int | 是 | 父级权限id |
| auth_c | string | 否 | 控制器名 |
| auth_a | string | 否 | 方法名 |
| is_nav | int | 是 | 是否菜单权限 1是 0否 |
3、返回数据
| 名称 | 备注 |
|---|---|
| id | 权限id |
| auth_name | 权限名称 |
| pid | 父id |
| pid_path | 家族图谱（祖先id_父id）,示例：0_1_2 |
| auth_c | 控制器名称 |
| auth_a | 方法名称 |
| is_nav | 是否菜单权限 1是 0否 |
| level | 级别 0 1 2 3 ， 0为最顶级 |
4、返回示例
{
"id": 65,
"auth_name": "添加权限",
"pid": 10,
"pid_path": "0_2_5_10",
"auth_c": "auth",
"auth_a": "create",
"is_nav": 0,
"level": 3
}
4.5、权限修改
1、请求地址
1、请求地址
PUT /auths/[:id]
需进行token认证
[:id] 为权限id
示例： http://adminapi.tbyue.com/auths/2
2、请求参数
| 名称 | 类型 | 必填 | 备注 |
|---|---|---|---|
| auth_name | string | 是 | 权限名 |
| pid | int | 是 | 父级权限id |
| auth_c | string | 否 | 控制器名 |
| auth_a | string | 否 | 方法名 |
| is_nav | int | 是 | 是否菜单权限 1是 0否 |
3、返回数据
| 名称 | 备注 |
|---|---|
| id | 权限id |
| auth_name | 权限名称 |
| pid | 父id |
| pid_path | 家族图谱（祖先id_父id）,示例：0_1_2 |
| auth_c | 控制器名称 |
| auth_a | 方法名称 |
| is_nav | 是否菜单权限 1是 0否 |
| level | 级别 0 1 2 3 ， 0为最顶级 |
4、返回示例
{
"id": 65,
"auth_name": "添加权限",
"pid": 10,
"pid_path": "0_2_5_10",
"auth_c": "auth",
"auth_a": "create",
"is_nav": 0,
"level": 3
}
4.6、权限删除
1、请求地址
1、请求地址
DELETE /auths/[:id]
需进行token认证
[:id] 为权限id
示例： http://adminapi.tbyue.com/auths/2
2、请求参数
无
3、返回数据
无
4、返回示例
无
4.7 获取菜单权限
1、请求地址
GET /nav
需进行token认证
示例： http://adminapi.tbyue.com/nav
2、请求参数
无
3、返回数据
返回父子级树状结构 数据集[{},{},...]
| 名称 | 备注 |
|---|---|
| id | 权限id |
| auth_name | 权限名称 |
| pid | 父id |
| pid_path | 家族图谱（祖先id_父id）,示例：0_1_2 |
| auth_c | 控制器名称 |
| auth_a | 方法名称 |
| is_nav | 是否菜单权限 1是 0否 |
| level | 级别 0 1 2 3 ， 0为最顶级 |
| son | 子权限数据集 |
