菜单树-详细
菜单 - 获取菜单详情
接口信息
- 接口地址:
{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}'
返回结果
code 为 200 表示调用成功;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 嵌套) |
查看完整菜单结构,用于编辑菜单 |
注意事项
- 本接口返回的
menu_tree_items 包含完整的多级结构,可直接用于 菜单树-更新 的请求参数(编辑后提交)
- 与
menu/list 不同,本接口的 data 为对象而非数组,因为一次只查询一个菜单树