创建菜单导航

POST 
/openapi/2026-01/menus

为店铺创建一个自定义菜单。

请求

application/json

请求体

请求体必填

titlestring必填

菜单名称

categoryint32

菜单分类。本接口只用于创建自定义菜单（3），内置菜单由平台维护；不传默认 3

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"
    }
  }
}