可以添加的装修卡片列表信息

主题 Liquid - 获取 DIY 页面内容导航添加版块列表

获取 DIY 编辑器中所有可用的装修卡片列表，按 Tab 分组，方便编辑器左侧面板展示卡片供用户拖拽或添加使用。

接口信息

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

认证

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

请求参数

无请求参数（GET 请求，body 为空）。

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/theme-liquid/get-page-content-diy-navigation-add-sections' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "tab_title": { ... },
        "sections": {
            "section_arr": { ... },
            "groups": { ... }
        }
    },
    "message": "success"
}

返回字段说明

顶层

data

data.tab_title — 装修卡片的分组

tab_title 定义了编辑器左侧的 Tab 分组，每个 key 对应一个分组，value 为该分组的多语言名称信息：

分组列表：

data.sections — 可添加的装修卡片信息

包含两个部分：section_arr 和 groups。

data.sections.section_arr — 各分组对应的装修卡片列表

按分组代码列出所有可添加的 section type，每个分类下的值为该分类可用的 section 类型标识数组：

data.sections.groups — 各分组的详细卡片信息

groups 对每个分组进行了更详细的说明。每个分组下面可能再分为子分组，子分组中包含卡片的名称、类型、默认设置、默认子块等完整信息。

结构为：

groups → {分组代码} → {子分组key} → { category, sections[] }

其中：

• 第一层 key 为分组代码（static、dynamic、form、addon、css），与 tab_title 的 code 对应
• 第二层 key 为子分组标识，可能是 empty_category（无子分组）或一个 hash ID
• 第二层 category — 子分组名称（多语言对象 { text, lang_params }）
• 第二层 sections — 该子分组下的卡片列表（Array），每项为一个完整的卡片信息对象

单个 section 详情

blocks 子项

分组结构示例

static 静态卡片分组：

dynamic 数据卡片分组：

form 表单卡片分组：

addon 插件卡片分组：

css 卡片分组：

注意事项

1. section_arr 为所有可用 section type 的汇总列表，方便快速遍历
2. groups 提供带分类分组的详细配置，供编辑器按分类展示卡片面板
3. sections 的 type 值即为 get-liquid-html 接口中 diy_config.sections key 的前缀部分
4. card_type 对应 tab_title 的分类 code，用于确定卡片归属哪个 Tab
5. 分组 key（如上表中的 hash 值）是后端确定的分组标识，不同站点可能不同