**版本：202701**

# 创建菜单导航

**POST** `/openapi/2027-01/menus`

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

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `title` string (required)

  菜单名称
- `category` int32

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

  菜单项树

  *   Array \[

  - `id` int64

    该菜单中已有菜单项的 id。更新时传入则原地更新该项并保留 id，不传则新建一项；创建菜单时忽略
  - `title` string

    菜单项名称
  - `target` string

    链接打开方式，如 `_blank` 为新窗口打开
  - `disabled` int32

    是否禁用：`1` 禁用，`0` 启用
  - `url_obj` object

    菜单项的链接；不传表示无跳转

    - `type` string

      链接类型，如 `home`、`product`、`collection`、`page`、`article`、`blog`、`web`； 无法识别的取值按无跳转（`0`）保存
    - `source_id` string

      链接到的资源 id（商品、专辑、页面等）
    - `url` string

      链接地址
  - `children` undefined[]

    子菜单项，可任意层嵌套
  *   \]

```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**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `menu` object

    新建的菜单

    - `id` string

      菜单 id

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