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 ''
返回结果
code 为 200 表示调用成功;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] |
该页面类型下可用的模板布局样式列表 |
注意事项
page_type 为必填,必须是 5 种类型之一
- 返回的
template_types 即为编辑页面中可选用的 layout 值