Base Get Template Types API 文档

得到模版layout布局列表

接口信息

  • 接口地址: {your-site-url}/api/skill/base/get-template-types
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/apimanager666
  • 请求方式: POST
  • Content-Type: application/json
  • 说明: 此接口用于获取指定页面类型下新架构模板支持的布局样式列表。类似于 Shopify 的模板功能:在模板装修中为某页面类型创建多个 layout,发布模板后,在对应页面的编辑界面即可选用其中一个 layout。

认证

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

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

请求参数 (Query String)

字段 类型 必填 说明
page_type string ✅ 必填 页面类型

page_type 可选值

取值 说明
product 商品详情页
collection 专辑列表页
page 自定义页面
blog_collection 博客列表页
blog_article 博客文章详情页

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/base/get-template-types?page_type=product' \
--header 'skill-access-token: {your-skill-access-token}' \
--data-raw ''

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "template_types": [
            "product",
            "product.custom-layout-1",
            "product.custom-layout-2",
            "product.custom-layout-3",
            "product.custom-layout-4",
            "product.custom-layout-5",
            "product.full-width-slider",
            "product.grid-1-column",
            "product.grid-2-columns",
            "product.grid-mix-columns"
        ]
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码,200 表示成功
message String 执行结果的文字描述
data.template_types Array[string] 该页面类型下可用的模板布局样式列表

注意事项

  1. page_type 为必填,必须是 5 种类型之一
  2. 返回的 template_types 即为编辑页面中可选用的 layout 值
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-05-11 17:00:18

results matching ""

    No results matching ""