菜单树-详细

菜单 - 获取菜单详情

接口信息

  • 接口地址: {your-site-url}/api/skill/menu/info
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/apimanager666
  • 请求方式: GET
  • 说明: 此接口用于获取指定菜单树的详细信息,包含菜单树基本信息和完整的多级菜单子项树结构(含二级、三级等所有层级)。

认证

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

Header
skill-access-token {your-skill-access-token} (请替换为你自己的 token)

请求参数 (Query String)

字段 类型 必填 说明
menu_id int 菜单树 ID

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/menu/info?menu_id=745' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "menu": {
            "id": 745,
            "s_id": 18,
            "shop_id": 15,
            "name": "terry tree",
            "can_delete": 1,
            "created_at": "2026-06-04 22:15:05",
            "updated_at": "2026-06-04 22:15:05",
            "remote_id": 0
        },
        "menu_tree_items": [
            {
                "id": 2372,
                "shop_id": 15,
                "menu_id": 745,
                "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": "2026-06-04 22:15:05",
                "updated_at": "2026-06-04 22:15:05",
                "remote_id": 0,
                "child": []
            },
            {
                "id": 2373,
                "shop_id": 15,
                "menu_id": 745,
                "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": "2026-06-04 22:15:05",
                "updated_at": "2026-06-04 22:15:05",
                "remote_id": 0,
                "child": [
                    {
                        "id": 2374,
                        "shop_id": 15,
                        "menu_id": 745,
                        "name": "Dress",
                        "parent_id": 2373,
                        "url_type": 2,
                        "url_value": "/collections/outdoor-lighting-atx0mv5u",
                        "object_id": 360,
                        "object_title": "Outdoor Lighting",
                        "open_new": 2,
                        "is_hidden": 2,
                        "level": 2,
                        "position": 0,
                        "created_at": "2026-06-04 22:15:05",
                        "updated_at": "2026-06-04 22:15:05",
                        "remote_id": 0,
                        "child": []
                    }
                ]
            }
        ]
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码,200 表示成功
message String 执行结果的文字描述
data Object 菜单详情数据

data 字段

字段 类型 说明
menu Object 菜单树基本信息
menu_tree_items Array[Object] 完整的菜单子项树结构,包含所有层级。一级子项通过 child 嵌套二级,二级通过 child 嵌套三级,以此类推
字段 类型 说明
id int 菜单树 ID(数据库主键)
s_id int 店铺内部菜单 ID(头部导航固定为 1,尾部固定为 2,其余依次递增)
shop_id int 店铺 ID
name string 菜单名称
can_delete int 是否可删除。1 = 可删除,2 = 不可删除(系统默认菜单树)
remote_id int 远程 ID,用于数据同步
created_at string 创建时间
updated_at string 最后更新时间
字段 类型 说明
id int 菜单子项 ID
shop_id int 店铺 ID
menu_id int 所属菜单树 ID
name string 菜单子项名称
parent_id int 父级 ID。0 表示一级菜单
url_type int 菜单链接类型。code 值从 菜单-Url选择器 获取
url_value string 菜单链接值
object_id int 链接类型对应的实体 ID(如商品 ID、页面 ID 等)
object_title string 对应实体的标题(如商品标题、页面标题等)
open_new int 是否新窗口打开。1 = 是,2 = 否
is_hidden int 是否隐藏。1 = 是,2 = 否
level int 菜单层级
position int 排序位置
created_at string 创建时间
updated_at string 最后更新时间
remote_id int 远程 ID,用于数据同步
child Array[Object] 下级子菜单数组,结构递归同 menu_tree_items 子项,支持所有层级

与菜单列表接口的区别

接口 获取子菜单层级 用途
菜单树-列表 仅一级(item 快速浏览所有菜单树概览
本接口 全部层级(menu_tree_items,通过 child 嵌套) 查看完整菜单结构,用于编辑菜单

注意事项

  1. 本接口返回的 menu_tree_items 包含完整的多级结构,可直接用于 菜单树-更新 的请求参数(编辑后提交)
  2. menu/list 不同,本接口的 data 为对象而非数组,因为一次只查询一个菜单树
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-06-04 22:31:03

results matching ""

    No results matching ""