菜单树-更新

接口信息

• 接口地址: {your-site-url}/api/skill/menu/update
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: POST
• 说明: 此接口用于更新一个已有的菜单树（包括菜单子项的增删改）。将传入的完整 menu_items 替换菜单树原有的子项结构。返回 data 为空数组表示更新成功。

⚠️ 重要：更新前请务必先通过 菜单树-详细 获取当前菜单的完整数据（menu_tree_items），在此基础上修改后再提交更新。直接用旧数据或构造不全的数据提交会导致丢失未包含的子项。

认证

请求头中需要携带 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

以下字段后端自动处理，无需传入（即使获取详情时返回了，提交时也不需要传）：

• shop_id、menu_id、parent_id、level、position — 后端根据菜单树和嵌套层级自动设置
• created_at、updated_at — 后端自动维护
• remote_id — 后端自动处理

前端辅助字段（后端忽略，可传可不传）：

• randomId — 前端用于列表渲染的临时唯一标识
• isDown — 前端用于标记子项展开/折叠状态

请求示例

示例一：更新已有菜单（保留现有子项 + 修改 + 新增）

{
    "menu_id": 745,
    "menu_name": "terry tree",
    "menu_items": [
        {
            "id": 2372,
            "name": "Home",
            "url_type": 1,
            "url_value": "/",
            "object_id": "",
            "object_title": "",
            "open_new": 2,
            "is_hidden": 2,
            "child": []
        },
        {
            "id": 2373,
            "name": "Collections",
            "url_type": 2,
            "url_value": "/collections/spu",
            "object_id": 366,
            "object_title": "智能专辑：spu",
            "open_new": 2,
            "is_hidden": 2,
            "child": [
                {
                    "id": "",
                    "name": "child dress",
                    "url_type": "",
                    "url_value": "",
                    "object_id": "",
                    "object_title": "",
                    "open_new": 2,
                    "is_hidden": 2,
                    "child": []
                }
            ]
        },
        {
            "id": "",
            "name": "dress",
            "url_type": 2,
            "url_value": "/collections/spu",
            "object_id": 366,
            "object_title": "智能专辑：spu",
            "open_new": 2,
            "is_hidden": 2,
            "child": []
        }
    ]
}

示例说明：

• id: 2372 → 有 ID，更新现有子项 "Home"
• id: 2373 + child 中的 id: "" → 父项更新，子项新增
• 最后一个 id: "" → 新增一级菜单项 "dress"
• 未包含在 menu_items 中的旧子项将被删除

cURL

curl --location --request POST '{your-site-url}/api/skill/menu/update' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{"menu_id":747,"menu_name":"Main Menu","menu_items":[{"id":"","name":"Home","url_type":1,"url_value":"/","object_id":"","object_title":"","open_new":2,"is_hidden":2,"child":[]},{"id":"","name":"Products","url_type":3,"url_value":"/products/diamond-chain-earrings-02d9fu8a","object_id":7042,"object_title":"Diamond Chain Earrings","open_new":2,"is_hidden":2,"child":[{"id":"","name":"Sub Product","url_type":2,"url_value":"/collections/53535243","object_id":372,"object_title":"53535243","open_new":1,"is_hidden":1,"child":[]}]}]}'

返回结果

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

成功响应

{
    "code": 200,
    "data": [],
    "message": "success"
}

返回字段说明

注意事项

更新流程

1. 先调用 菜单树-详细 获取当前菜单完整数据
2. 取出 data.menu_tree_items，在此基础上进行修改（增删改子项、修改名称/链接等）
3. 提交时只保留必要字段，去掉 shop_id、menu_id、parent_id、level、position、created_at、updated_at、remote_id

增删改规则

• 更新采用全量替换策略：传入的 menu_items 会完全替换该菜单树下原有的所有子项
• 已存在的子项传入数据库 id（整数），系统根据 id 判断是更新
• 新增的子项 id 留空 ""，系统会自动分配新 ID
• 未包含在 menu_items 中的旧子项将被删除
• child 支持无限级嵌套，父级关系由嵌套层级自动推断，无需手动设置 parent_id
• url_type 和对应的 object_id / url_value 需匹配，新项目可先留空