优特云
[ { "name": "首页", "url": "http://www.utyun.com/", "target": "0", "child": [] }, { "name": "活动", "url": "http://www.utyun.com/h-col-141.html", "target": "0", "child": [] }, { "name": "产品", "url": "", "target": "1", "child": [ { "name": "U语言", "url": "http://www.utyun.com/h-col-176.html", "target": "0", "child": [] }, { "name": "U平台", "url": "http://www.utyun.com/h-col-150.html", "target": "0", "child": [] } ] }, { "name": "技术与服务", "url": "", "target": "1", "child": [ { "name": "运维服务", "url": "http://www.utyun.com/h-col-161.html", "target": "0", "child": [] }, { "name": "技术方案", "url": "http://www.utyun.com/h-col-178.html", "target": "0", "child": [] } ] }, { "name": "优特云学院", "url": "", "target": "1", "child": [ { "name": "教程", "url": "http://www.utyun.com/h-col-166.html", "target": "0", "child": [] }, { "name": "下载中心", "url": "http://www.utyun.com/h-col-170.html", "target": "0", "child": [] }, { "name": "论坛", "url": "http://www.utyun.com/h-col-169.html", "target": "0", "child": [] } ] }, { "name": "关于优特云", "url": "", "target": "1", "child": [ { "name": "企业概况", "url": "http://www.utyun.com/h-col-171.html", "target": "0", "child": [] }, { "name": "新闻动态", "url": "http://www.utyun.com/h-col-172.html", "target": "0", "child": [] }, { "name": "加入我们", "url": "http://www.utyun.com/h-col-173.html", "target": "0", "child": [] }, { "name": "团队风采", "url": "http://www.utyun.com/h-col-140.html", "target": "0", "child": [] } ] } ]
文档中心 试用中心

菜单服务
菜单服务-使用手册

奕河 最后一次编辑

3 年多前 78

组件介绍

菜单服务提供菜单维护及权限管理的功能，实现了统一前端菜单信息维护及细粒度权限的用户菜单控制。

API 参考

API 列表（共10个）

序号接口接口描述版本
1获取用户可见菜单【登录时使用】GET： /menu2/menusV1.00
2删除菜单POST： /menu2/deleteMenuV1.00
3获取应用菜单树GET： /menu2/listMenusV1.00
4根据菜单ID获取菜单GET： /menu2/menuV1.00
5新增菜单POST： /menu2/menuV1.00
6菜单绑定 功能POST： /menu2/menuBindAuthV1.00
7菜单绑定 角色POST： /menu2/menuBindAuthGroupV1.00
8菜单解绑 功能POST： /menu2/menuUnBindAuthV1.00
9菜单解绑 角色POST： /menu2/menuUnBindAuthGroup
10修改菜单信息 POST： /menu2/updateMenu  

获取用户可见菜单【登录时使用】

基本信息
Path： /menu2/menus
Method： GET
接口描述：
请求参数
Query
参数名称是否必须示例备注
appKey是应用Key
返回数据
名称类型是否必须默认值备注其他信息
object []非必须item 类型: object
├─ appKeystring必须所属应用
├─ authGroupNamesstring必须逗号风格的角色组名，如果为空，或者空字符串，则表示所有用户都拥有
├─ childrenstring[]非必须item 类型: string
├─非必须
├─ idinteger必须菜单idformat: int64
├─ menuLogostring必须菜单logo
├─ menuNamestring必须 菜单名称  
├─ menuOrdernumber必须 菜单序号  format: double
├─ menuTypeinteger必须菜单类型 0:页面菜单，1：功能菜单format: int32
├─ menuUrlstring必须 菜单url  
├─ parentIdinteger必须父菜单Idformat: int64
├─ roleNamesstring必须逗号风格的角色名，如果为空，或者空字符串，则表示所有用户都拥有

删除菜单

基本信息
Path：/menu2/deleteMenu
Method： POST
接口描述：
请求参数
Headers
参数名称参数值是否必须示例备注
Content-Type application/json是
Body
名称类型是否必须默认值备注其他信息
menuIdinteger必须Long类型，菜单Id
appKeystring必须应用Key

获取应用菜单树

基本信息
Path： /menu2/listMenus
Method： GET
接口描述：
请求参数
Query
参数名称是否必须示例备注
appKey是应用Key
返回数据
名称类型是否必须默认值备注其他信息
object []非必须item 类型: object
├─ appKeystring必须所属应用
├─ authGroupNamesstring必须逗号风格的角色组名，如果为空，或者空字符串，则表示所有用户都拥有
├─ childrenstring[]非必须item 类型: string
├─非必须
├─ idinteger必须菜单idformat: int64
├─ menuLogostring必须菜单logo
├─ menuNamestring必须 菜单名称  
├─ menuOrdernumber必须 菜单序号  format: double
├─ menuTypeinteger必须菜单类型 0:页面菜单，1：功能菜单format: int32
├─ menuUrlstring必须 菜单url  
├─ parentIdinteger必须父菜单Idformat: int64
├─ roleNamesstring必须逗号风格的角色名，如果为空，或者空字符串，则表示所有用户都拥有

根据菜单ID获取菜单

基本信息
Path： /menu2/menu
Method： GET
接口描述：
请求参数
Query
参数名称是否必须示例备注
menuId是菜单ID
appKey是应用Key
返回数据
名称类型是否必须默认值备注其他信息
object []非必须item 类型: object
├─ appKeystring必须所属应用
├─ authGroupNamesstring必须逗号风格的角色组名，如果为空，或者空字符串，则表示所有用户都拥有
├─ childrenstring[]非必须item 类型: string
├─非必须
├─ idinteger必须菜单idformat: int64
├─ menuLogostring必须菜单logo
├─ menuNamestring必须 菜单名称  
├─ menuOrdernumber必须 菜单序号  format: double
├─ menuTypeinteger必须菜单类型 0:页面菜单，1：功能菜单format: int32
├─ menuUrlstring必须 菜单url  
├─ parentIdinteger必须父菜单Idformat: int64
├─ roleNamesstring必须逗号风格的角色名，如果为空，或者空字符串，则表示所有用户都拥有

新增菜单

基本信息
Path： /menu2/menu
Method： GET
接口描述：
请求参数
Headers
参数名称参数值是否必须示例备注
Content-Typeapplication/json是
Body
名称类型是否必须默认值备注其他信息
appKeystring必须所属应用
authGroupNamesstring必须逗号风格的角色组名，如果为空，或者空字符串，则表示所有用户都拥有
childrenstring[]非必须item 类型: string
├─非必须
 idinteger必须菜单idformat: int64
menuLogostring必须菜单logo
menuNamestring必须 菜单名称  
menuOrdernumber必须 菜单序号  format: double
menuTypeinteger必须菜单类型 0:页面菜单，1：功能菜单format: int32
menuUrlstring必须 菜单url  
parentIdinteger必须父菜单Idformat: int64
 roleNamesstring必须逗号风格的角色名，如果为空，或者空字符串，则表示所有用户都拥有
返回数据
名称类型是否必须默认值备注其他信息
appKeystring必须所属应用
authGroupNamesstring必须逗号风格的角色组名，如果为空，或者空字符串，则表示所有用户都拥有
childrenstring[]非必须item 类型: string
├─非必须
 idinteger必须菜单idformat: int64
menuLogostring必须菜单logo
menuNamestring必须 菜单名称  
menuOrdernumber必须 菜单序号  format: double
menuTypeinteger必须菜单类型 0:页面菜单，1：功能菜单format: int32
menuUrlstring必须 菜单url  
parentIdinteger必须父菜单Idformat: int64
 roleNamesstring必须逗号风格的角色名，如果为空，或者空字符串，则表示所有用户都拥有

菜单绑定 功能

基本信息
Path： /menu2/menuBindAuth
Method： POST
接口描述：
请求参数
Headers
参数名称参数值是否必须示例备注
Content-Typeapplication/json是
Body
名称类型是否必须默认值备注其他信息
authorityKeysstring []必须item 类型: string
├─非必须
menuIdinteger必须菜单Idformat: int64

菜单绑定 角色

基本信息
Path： /menu2/menuBindAuthGroup
Method： POST
接口描述：
请求参数
Headers
参数名称参数值是否必须示例备注
Content-Typeapplication/json是
Body
名称类型是否必须默认值备注其他信息
authorityGroupKeysstring []必须item 类型: string
├─非必须
menuIdinteger必须菜单Idformat: int64

菜单解绑 功能

基本信息
Path： /menu2/menuUnBindAuth
Method： POST
接口描述：
请求参数
Headers
参数名称参数值是否必须示例备注
Content-Typeapplication/json是
Body
名称类型是否必须默认值备注其他信息
authorityKeysstring []必须item 类型: string
├─非必须
menuIdinteger必须菜单Idformat: int64

菜单解绑 角色

基本信息
Path： /menu2/menuUnBindAuthGroup
Method： POST
接口描述：
请求参数
Headers
参数名称参数值是否必须示例备注
Content-Typeapplication/json是
名称类型是否必须默认值备注其他信息
authorityVGroupKeysstring []必须item 类型: string
├─非必须
menuIdinteger必须菜单Idformat: int64
返回数据
名称类型是否必须默认值备注其他信息

修改菜单信息

基本信息
Path： /menu2/updateMenu
Method： POST
接口描述：
请求参数
Headers
参数名称参数值是否必须示例备注
Content-Typeapplication/json是
Body
名称类型是否必须默认值备注其他信息
appKeystring必须所属应用
authGroupNamesstring必须逗号风格的角色组名，如果为空，或者空字符串，则表示所有用户都拥有
childrenstring[]非必须item 类型: string
├─非必须
 idinteger必须菜单idformat: int64
menuLogostring必须菜单logo
menuNamestring必须 菜单名称  
menuOrdernumber必须 菜单序号  format: double
menuTypeinteger必须菜单类型 0:页面菜单，1：功能菜单format: int32
menuUrlstring必须 菜单url  
parentIdinteger必须父菜单Idformat: int64
 roleNamesstring必须逗号风格的角色名，如果为空，或者空字符串，则表示所有用户都拥有
返回数据
名称类型是否必须默认值备注其他信息

产品版本

日期修改描述
2019-6-21初版发布
2020-4-18优化：修改获取菜单接口，对于在应用下没有权限的用户，菜单返回空
2020-4-26新特性：技术部要求统一异常规范, 更新logback，简化客户端的异常处理方式
2020-5-20新特性：提升swagger的版本，补充swagger模型的注释，清晰明确接口的调用

更新日志

日期修改描述
2019-6-21发布菜单服务，创建菜单服务的用户使用手册
优特云