电商管理后台 API 接口文档 (3)

响应参数

参数名 参数说明 备注
id   权限 ID    
authName   权限说明    
level   权限层级    
pid   权限父 ID    
path   对应访问路径    

响应数据 type=list

{ "data": [ { "id": 101, "authName": "商品管理", "level": "0", "pid": 0, "path": null }, { "id": 102, "authName": "订单管理", "level": "0", "pid": 0, "path": null } ], "meta": { "msg": "获取权限列表成功", "status": 200 } }

type=tree

{ data: [ { id: 101, authName: \'商品管理\', path: null, pid: 0, children: [ { id: 104, authName: \'商品列表\', path: null, pid: 101, children: [ { id: 105, authName: \'添加商品\', path: null, pid: \'104,101\' } ] } ] } ], meta: { msg: \'获取权限列表成功\', status: 200 } } 1.4.2. 左侧菜单权限

请求路径：menus

请求方法：get

响应数据

{ "data": { "id": 101, "authName": "商品管理", "path": null, "children": [ { "id": 104, "authName": "商品列表", "path": null, "children": [] } ] } "meta": { "msg": "获取菜单列表成功", "status": 200 } } 1.5. 角色管理 1.5.1. 角色列表

请求路径：roles

请求方法：get

响应数据说明

第一层为角色信息

第二层开始为权限说明，权限一共有 3 层权限

最后一层权限，不包含 children 属性

响应数据

{ "data": [ { "id": 30, "roleName": "主管", "roleDesc": "技术负责人", "children": [ { "id": 101, "authName": "商品管理", "path": null, "children": [ { "id": 104, "authName": "商品列表", "path": null, "children": [ { "id": 105, "authName": "添加商品", "path": null } ] } ] } ] } ], "meta": { "msg": "获取成功", "status": 200 } } 1.5.2. 添加角色

请求路径：roles

请求方法：post

请求参数

参数名 参数说明 备注
roleName   角色名称   不能为空  
roleDesc   角色描述   可以为空  

响应参数

参数名 参数说明 备注
roleId   角色 ID    
roleName   角色名称    
roleDesc   角色描述    

响应数据

{ "data": { "roleId": 40, "roleName": "admin2", "roleDesc": "admin2Desc" }, "meta": { "msg": "创建成功", "status": 201 } } 1.5.3. 根据 ID 查询角色

请求路径：roles/:id

请求方法：get

请求参数

参数名 参数说明 备注
:id   角色 ID   不能为空携带在url中  

响应参数

参数名 参数说明 备注
roleId   角色 ID    
roleName   角色名称    
roleDesc   角色描述    

响应数据

{ "data": { "roleId": 31, "roleName": "测试角色", "roleDesc": "测试负责人" }, "meta": { "msg": "获取成功", "status": 200 } } 1.5.4. 编辑提交角色

请求路径：roles/:id

请求方法：put

请求参数

参数名 参数说明 备注
:id   角色 ID   不能为空携带在url中  
roleName   角色名称   不能为空  
roleDesc   角色描述   可以为空  

响应数据

{ "data": { "roleId": 31, "roleName": "测试角色", "roleDesc": "测试角色描述" }, "meta": { "msg": "获取成功", "status": 200 } } 1.5.5. 删除角色

请求路径：roles/:id

请求方法：delete

请求参数

参数名 参数说明 备注
:id   角色 ID   不能为空携带在url中  

响应数据

{ "data": null, "meta": { "msg": "删除成功", "status": 200 } } 1.5.6. 角色授权

请求路径：roles/:roleId/rights

请求方法：post

请求参数：通过 请求体 发送给后端

参数名 参数说明 备注
:roleId   角色 ID   不能为空携带在url中  
rids   权限 ID 列表（字符串）   以 , 分割的权限 ID 列表（获取所有被选中、叶子节点的key和半选中节点的key, 包括 1，2，3级节点）  

响应数据

{ "data": null, "meta": { "msg": "更新成功", "status": 200 } } 1.5.7. 删除角色指定权限

请求路径：roles/:roleId/rights/:rightId

请求方法：delete