更新菜单导航

PUT 
/openapi/2027-01/menus/:id

更新菜单的名称与菜单项；内置菜单可修改的字段有限。

请求

Path参数

id string必填

要更新的菜单 id

application/json

请求体

请求体必填

titlestring

新名称。可选，不传则保持原样

categoryint32

菜单分类（自定义菜单 = 3）。可选；传 0 或不传都保持原值

children object[]
菜单项树。传入时整体替换现有菜单项，未包含的已有项会被删除；不传保持原有菜单项；传空数组清空全部菜单项
Array [
idint64
该菜单中已有菜单项的 id。更新时传入则原地更新该项并保留 id，不传则新建一项；创建菜单时忽略
titlestring
菜单项名称
targetstring
链接打开方式，如 _blank 为新窗口打开
disabledint32
是否禁用：1 禁用，0 启用
url_obj object
菜单项的链接；不传表示无跳转
typestring
链接类型，如 home、product、collection、page、article、blog、web； 无法识别的取值按无跳转（0）保存
source_idstring
链接到的资源 id（商品、专辑、页面等）
urlstring
链接地址
childrenundefined[]
子菜单项，可任意层嵌套
]

示例

json

{
  "title": "string",
  "category": 0,
  "children": [
    {
      "id": 0,
      "title": "string",
      "target": "string",
      "disabled": 0,
      "url_obj": {
        "type": "string",
        "source_id": "string",
        "url": "string"
      },
      "children": [
        null
      ]
    }
  ]
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

menu object

更新后的菜单

idstring

菜单 id

示例

json

{
  "code": "string",
  "message": "string",
  "data": {
    "menu": {
      "id": "string"
    }
  }
}