模版装修-得到可以增加的section列表

主题 Liquid - 获取 DIY 导航添加模块:获取 DIY 主题装修中可添加到页面的模块（sections）列表。包含所有可用模块的基本信息：类型名称、分类、多语言名称、card_type、预设 blocks 结构等。

接口信息

• 接口地址: {your-site-url}/api/skill/theme-liquid/get-diy-navigation-add-sections
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: POST

认证

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

请求参数 (JSON Body)

请求示例

请求体 JSON

{
    "theme_id": "832",
    "sections_type": "header-group",
    "page_type": "home"
}

cURL

curl --location --request POST '{your-site-url}/api/skill/theme-liquid/get-diy-navigation-add-sections' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{"theme_id":"832","sections_type":"header-group","page_type":"home"}'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "sections": {
            "section_arr": [
                "affiliate-banner-card",
                "banner-with-slider",
                "blog-posts",
                "cascading-collection",
                "cascading-product",
                "collection-list",
                "collage-tabs",
                "collapsible-tabs",
                "contact-form",
                "countdown-timer",
                "custom-code",
                "custom-content",
                "empty-space",
                "featured-collection",
                "gallery",
                "hotspots-image",
                "icon-box",
                "image-with-text",
                "newsletter",
                "product-bundles",
                "product-tabs",
                "promotion-banner",
                "rich-text",
                "slider",
                "testimonials",
                "video-hero",
                "video"
            ],
            "groups": {
                "empty_category": {
                    "category": "",
                    "sections": []
                },
                "6477351f...": {
                    "category": {
                        "text": "插件",
                        "lang_params": { "en": "Plugin", "tw": "插件" }
                    },
                    "sections": []
                },
                "7f722e54...": {
                    "category": {
                        "text": "专辑",
                        "lang_params": { "en": "Collection", "tw": "專輯" }
                    },
                    "sections": []
                }
            }
        }
    },
    "message": "success"
}

返回字段说明

data → sections 字段

groups 分组对象字段

category 对象字段（多语言）

section 子项字段

blocks 子项通用字段

已知 card_type 说明

注意事项

1. sections_type 决定返回哪个区域的可用模块，不同区域可用的模块可能不同
2. section_arr 是本节所有可用 section 类型的汇总名称列表
3. groups 中按分类组织 section 详情。empty_category（key 为空字符串）包含未归类的 section
4. settings 和 blocks[].settings 结构因 section 类型而异，添加 section 时需要提供完整的 settings 结构
5. 多语言字段（name、category）结构为 { text: "默认文本", lang_params: { "en": "...", "tw": "..." } }
6. 获取到的 section 详情可用于构建"添加模块"的请求体，将选中的 section 数据提交到 set-diy-navigation 或类似 API