[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": "參數錯誤!" } ```