[TOC] ## 角色列表 * 请求地址: `/role` * 请求方式: get * 请求参数: 无 * 成功返回: ```json { "code": 0, "data": [ { "ID": 2, "Lft": 1, "Rght": 2, "Title": "标准用户",//角色名 "Description": "标准用户"//角色描述 } ] } ``` >[info] 前三个参数角色必须 暂不操作 ## 添加角色 * 请求地址: `/role/save` * 请求方式: post * 请求参数: | 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 | | --- | --- | --- | --- | --- | | `title` | string | 2-128 | `是` | 角色名 | | `description` | string | 2-255 | `是` | 角色描述 | * 成功返回: ```json { "code":0 } ``` * 失败返回: ```json { "code": -1, "msg": "参数错误!" } ``` ## 修改角色 * 请求地址: `/role/update` * 请求方式: post * 请求参数: | 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 | | --- | --- | --- | --- | --- | | `id` | int | 11 | `是` | id | | `title` | string | 2-128 | `是` | 角色名 | | `description` | string | 2-255 | `是` | 角色描述 | * 成功返回: ```json { "code":0 } ``` * 失败返回: ```json { "code": -1, "msg": "参数错误!" } ``` ## 删除角色 * 请求地址: `/role/delete` * 请求方式: post * 请求参数: | 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 | | --- | --- | --- | --- | --- | | `id` | int | 11 | `是` | id | * 成功返回: ```json { "code":0 } ``` * 失败返回: ```json { "code": -1, "msg": "参数错误!" } ``` ## 获取可选的功能 * 请求地址: `/role/permissionsTree` * 请求方式: get * 请求参数: 无 * 成功返回: ```json { "code": 0, "data": [ { "id": 1, "name": "基础设置", "description": "", "children": [ { "id": 3, "name": "banner广告位", "description": "" }, { "id": 4, "name": "水印设置", "description": "" }, { "id": 5, "name": "生活缴费设置", "description": "" } ] } ] } ``` * 失败返回: 其他错误信息 ## 获取拥有的权限 * 请求地址: `/role/permissionsForRole` * 请求方式: get * 请求参数: | 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 | | --- | --- | --- | --- | --- | | `role` | int | 11 | `是` | id | * 成功返回: ```json { "code": 0, "data": [ { "ID": 2, "Title": "基础设置", "Description": "" }, { "ID": 8, "Title": "小区管理", "Description": "" }, { "ID": 10, "Title": "区域管理", "Description": "" }, { "ID": 50, "Title": "内容管理", "Description": "" } ] } ``` * 失败返回: ```json { "code": -1, "msg": "参数错误!" } ``` ## 设置角色权限 * 请求地址: `/role/updatePermissionsForRole` * 请求方式: post * 请求参数: | 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 | | --- | --- | --- | --- | --- | | `role` | string | 2-128 | `是` | 原本的角色权限 | `permissions` | [] | 0 | `是` | 新的角色权限 * 成功返回: ```json { "code":0 } ``` * 失败返回: ```json { "code": -1, "msg": "参数错误!" } ```