Create or Update Menu Group¶
创建或修改菜单组。
请求格式¶
POST https://{apigw-address}/app-portal-service/v2.3/app/menuGroup/createOrUpdate
请求参数(URI)¶
名称 |
位置(Path/Query) |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|---|
orgId |
Query |
必需 |
String |
OU ID。如何获取 orgId 信息 >> |
请求参数(Body)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
menuGroupId |
可选 |
String |
菜单组 ID。若为修改菜单组,必须填写菜单组 ID。若为新建菜单组,需留空。 |
appId |
必需 |
String |
应用的 Access Key。如何获取 Access Key >> |
name |
可选 |
String |
菜单组名称。若为新建菜单组或修改已有菜单组的名称,需填写菜单组名称。若为修改菜单组的其它内容,需留空。 |
menuIds |
可选 |
List <string> |
菜单列表。创建菜单组时,若为空则创建一个空的菜单组。修改菜单组时,若为空则清除菜单组中的菜单,若指定菜单 ID,将清空菜单组内的已有菜单。 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
id |
String |
新建或修改的菜单组 ID。 |
name |
String |
新建或修改后的菜单组名称。 |
错误码¶
代码 |
描述 |
---|---|
31400 |
OU ID 或菜单组名称为空 |
31403 |
当前应用无权编辑菜单组 |
31404 |
可能原因如下:
|
31408 |
菜单组名称已存在 |
示例¶
请求示例¶
url: https://{apigw-address}/app-portal-service/v2.3/app/menuGroup/createOrUpdate?orgId=yourOrgId
method: POST
{
"menuGroupId": "your_menu_group_id",
"appId": "your_access_key",
"name": "your_app_name",
"menuIds": [
"your_menu_id_1",
"your_menu_id_2",
"your_menu_id_3",
"your_menu_id_4",
]
}
返回示例¶
{
"code": 0,
"message": "OK",
"data": {
"id": "your_menu_group_id",
"name": "your_menu_group_name"
}
}