菜单-Url选择器

菜单 - 获取菜单链接类型列表

接口信息

• 接口地址: {your-site-url}/api/skill/menu/get-item-types
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: GET
• 说明: 此接口用于获取菜单子项可选的链接类型列表。创建/编辑菜单子项时，用于下拉选择链接类型。

认证

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

请求参数 (Query String)

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/menu/get-item-types?theme_identity=new_default_theme_b2b' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

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

成功响应

{
    "code": 200,
    "data": [
        {
            "text": "首页",
            "url": "/",
            "code": 1
        },
        {
            "text": "商品专辑页",
            "url": "/collections/",
            "code": 2
        },
        {
            "text": "商品专辑页(所有商品)",
            "url": "/collections/all",
            "code": 10
        },
        {
            "text": "专辑列表页（指定专辑）",
            "url": "/collections",
            "code": 12
        },
        {
            "text": "商品详情页",
            "url": "/products/",
            "code": 3
        },
        {
            "text": "商品评论页",
            "url": "/review/all",
            "code": 11
        },
        {
            "text": "博客专辑页",
            "url": "/blogs/",
            "code": 4
        },
        {
            "text": "博客文章页",
            "url": "/blog/",
            "code": 5
        },
        {
            "text": "自定义页面",
            "url": "/pages/",
            "code": 6
        },
        {
            "text": "查询订单",
            "url": "/account/order-query",
            "code": 7
        },
        {
            "text": "Contacts",
            "url": "/contacts",
            "code": 9
        },
        {
            "text": "自定义URL",
            "code": 8,
            "url": ""
        }
    ],
    "message": "success"
}

返回字段说明

data 子项字段

url_type 类型枚举

url 中的动态变量（{handle}）如何获取

接口返回的 url 格式中，有的 url 存在动态变量，譬如：/collections/{handle}，这里的 {handle} 是商品专辑的 handle。要生成完整的链接，需要先通过相应的 api 获取实体的 handle、title 等信息。

只有 url 格式还不够：上面的 url 格式只是模板，要拿到具体的 url 值，还需要调用对应的 api 获取数据。譬如：商品，给定了商品 id，如果需要获取 {handle}，则需要通过商品详细 api，得到商品的 handle、title 等信息。

下面几种选择器的 url 存在动态数据：

• 商品专辑页（code 2）
• 商品详情页（code 3）
• 博客文章页（code 5）
• 博客专辑页（code 4）
• 自定义页面（code 6）

每种类型对应的 API 如下（列表 api 用于选择实体，详情 api 用于获取 handle、title 等信息）：

url 对象生成格式

对于使用选择器的数据，需要生成一定格式的 url 对象，包含 url_type、url_value、object_id、object_title 等字段：

1. 首页

• url_type：类型
• url_value：首页的 url path

{
    "url_type": 1,
    "url_value": "/",
    "object_id": "",
    "object_title": ""
}

2. 商品专辑

• url_type：类型
• url_value：商品专辑的 url path
• object_id：商品专辑 id
• object_title：商品专辑标题

{
    "url_type": 2,
    "url_value": "/collections/electric-nail-clippers",
    "object_id": 401,
    "object_title": "Electric Nail Clippers"
}

3. 商品

• url_type：类型
• url_value：商品的 url path
• object_id：商品 id
• object_title：商品标题

{
    "url_type": 3,
    "url_value": "/products/led-fiber-optic-baseball",
    "object_id": 7130,
    "object_title": "LED Fiber Optic Baseball"
}

4. 博客专辑

• url_type：类型
• url_value：博客专辑的 url path
• object_id：博客专辑 id
• object_title：博客专辑标题

{
    "url_type": 4,
    "url_value": "/blogs/fashion-news",
    "object_id": 66,
    "object_title": "Fashion News"
}

5. 博客文章

• url_type：类型
• url_value：博客文章的 url path
• object_id：博客文章 id
• object_title：博客文章标题

{
    "url_type": 5,
    "url_value": "/blog/top-10-dresses-2026",
    "object_id": 88,
    "object_title": "Top 10 Dresses 2026"
}

6. 自定义页面

• url_type：类型
• url_value：自定义页面的 url path
• object_id：自定义页面 id
• object_title：自定义页面标题

{
    "url_type": 6,
    "url_value": "/pages/about-us",
    "object_id": 23,
    "object_title": "About Us"
}

注意事项

1. theme_identity 为当前模版标识，不同模版可能支持不同的链接类型
2. code 对应菜单子项的 url_type 字段
3. 类型 1、7、9、10、11、12 为固定链接，选择后无需指定具体对象
4. 类型 2、3、4、5、6 为指定实体链接，选择后需通过其他 API 获取可选实体列表

5. 类型 8 为自定义 URL，url 需用户手动输入

6. 对于带动态变量的 url（商品专辑页、商品详情页、博客文章页、博客专辑页、自定义页面），需要通过对应的列表/详情 API 获取实体的 handle 等信息，再生成完整的 url 对象，详见上方「url 中的动态变量（{handle}）如何获取」与「url 对象生成格式」章节。