菜单树-创建

接口信息

• 接口地址: {your-site-url}/api/skill/menu/create
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: POST
• 说明: 此接口用于创建一个新的菜单树（包含多级菜单子项）。成功后返回全部菜单树列表。

认证

请求头中需要携带 skill-access-token：

请求参数 (JSON Body)

menu_items 子项字段

url_type 类型枚举

url 拼接规则：

• 固定链接（code 1、7、9、10、11、12）：url_value 直接取表中 url 的值
• 动态链接（code 2、3、4、5、6）：将 url 中的 {handle} 替换为所选实体的 handle
  • 例：商品 handle 为 diamond-chain-earrings-02d9fu8a，code=3 → url_value = /products/diamond-chain-earrings-02d9fu8a
• code 8（自定义 URL）：手动填写任意完整 URL，如 https://example.com/page

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/menu/create' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "menu_name": "terry tree",
    "menu_items": [
        {
            "id": "",
            "name": "Home",
            "url_type": 1,
            "url_value": "/",
            "object_id": "",
            "object_title": "",
            "open_new": 2,
            "is_hidden": 2,
            "child": []
        },
        {
            "id": "",
            "name": "Collections",
            "url_type": 2,
            "url_value": "/collections/spu",
            "object_id": 366,
            "object_title": "智能专辑：spu",
            "open_new": 2,
            "is_hidden": 2,
            "child": [
                {
                    "id": "",
                    "name": "Dress",
                    "url_type": 2,
                    "url_value": "/collections/outdoor-lighting-atx0mv5u",
                    "object_id": 360,
                    "object_title": "Outdoor Lighting",
                    "open_new": 2,
                    "is_hidden": 2,
                    "child": []
                }
            ]
        }
    ]
}'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

成功后返回全部菜单树列表（含新创建的菜单树），与 菜单树-列表 返回结构一致：

{
    "code": 200,
    "data": [
        {
            "id": 746,
            "s_id": 18,
            "shop_id": 15,
            "name": "terry tree",
            "can_delete": 1,
            "created_at": "2026-06-04 22:18:30",
            "updated_at": "2026-06-04 22:18:30",
            "remote_id": 0,
            "item": [
                {
                    "id": 2372,
                    "shop_id": 15,
                    "menu_id": 746,
                    "name": "Home",
                    "parent_id": 0,
                    "url_type": 1,
                    "url_value": "/",
                    "object_id": 0,
                    "object_title": "",
                    "open_new": 2,
                    "is_hidden": 2,
                    "level": 1,
                    "position": 0,
                    "created_at": 1780582710,
                    "updated_at": 1780582710,
                    "remote_id": 0
                },
                {
                    "id": 2373,
                    "shop_id": 15,
                    "menu_id": 746,
                    "name": "Collections",
                    "parent_id": 0,
                    "url_type": 2,
                    "url_value": "/collections/spu",
                    "object_id": 366,
                    "object_title": "智能专辑：spu",
                    "open_new": 2,
                    "is_hidden": 2,
                    "level": 1,
                    "position": 1,
                    "created_at": 1780582710,
                    "updated_at": 1780582710,
                    "remote_id": 0
                }
            ]
        }
    ],
    "message": "success"
}

返回字段说明

data 子项 - 菜单树字段

item 子项 - 菜单子项字段

注意事项

1. 创建时 menu_items 中各项的 id 留空即可，系统会自动分配
2. child 支持无限级嵌套，构建多级菜单结构
3. url_type 和对应的 object_id / url_value 需匹配，固定链接类型（如首页、联系我们）无需 object_id