关于 主题
访问范围
需要多个访问范围—请参阅每个端点以了解访问范围要求。
需要访问受保护的客户数据。
主题设计、上传修改 主题的能力，适用于自动化运营、定制主题开发。
bash
{
"theme": {
"isCurrent": "false",
"shopThemeName": "Down",
"createTime": "2024-18-12T08:18:49",
"shopThemeId": "1",
"updateTime": "2024-18-12T08:18:49",
"status": "INIT"
}
}POST 新增主题资产
更新店铺单个主题的主题资产。
访问范围
需要以下任意访问权限: write_themes
接口
POST /api/202412/themes/{theme_id}/assets
请求参数
assetsobject
创建主题资产对象
- 收起属性
codestring
定义主题资产编码值。
namestring
新建主题资产名称。
urlstring
新建主题资产文件路径。
fileTypestring
新建主题资产文件类型。
响应数据
assetsobject
新建主题资产，返回资产信息。
- 收起属性
namestring
主题资产名称，资产文件名.文件后缀。
urlstring
主题资产路径，/资产目录/资产文件名.文件后缀。
theme_idstring
店铺主题 ID，区分店铺安装的主题。
bash
curl -X POST \
https://{shop}.genmystore.com/api/202412/themes/{theme_id}/assets" \
-H "X-Genstore-Access-Token: {access_token}" \
-H "Content-Type: application/json" \
-d '{
"assets":{
"code":"PAGE",
"name":"wishlist",
"url":"templates/cus.json",
"fileType":"JSON 、LIQUID"
}
}'json
HTTP/1.1 200 OK
{
"assets": {
"name": "wishlist",
"theme_id": "1938530406471172098",
"url": "templates/cus.json"
}
}GET 获取主题列表
检索主题列表。
访问范围
需要以下任意访问权限: read_themes
接口
GET /api/202412/decoration/themes
请求参数
{}
响应数据
themesarray
主题列表。
- 收起属性
isCurrentboolean
店铺是否当前主题标识, true 是, false 否。
shopThemeNamestring
商户主题名称。
createTimestring
店铺主题创建时间（ISO 8601格式）。
shopThemeIdstring
商户主题ID。
updateTimestring
店铺主题更新时间（ISO 8601格式）。
statusstring
安装状态,枚举 ：INIT 初始化, SUCCESS 成功, FAIL 失败。
bash
curl -X GET \
https://{shop}.genmystore.com/api/202412/decoration/themes" \
-H "X-Genstore-Access-Token: {access_token}" \json
HTTP/1.1 200 OK
{
"themes": [
{
"isCurrent": "false",
"shopThemeName": "Down",
"createTime": "2024-18-12T08:18:49",
"shopThemeId": "1",
"updateTime": "2024-18-12T08:18:49",
"status": "INIT"
}
]
}GET 获取主题资产
获取店铺的主题资产信息。
访问范围
需要以下任意访问权限: read_themes
接口
GET /api/202412/decoration/assets/{shopThemeId}
请求参数
assetstring
店铺主题的资源地址。
响应数据
shopAssertobject
店铺的资产信息。
- 收起属性
createTimestring
店铺文件的创建时间（ISO 8601格式）。
contextstring
店铺文件内容。
updateTimestring
店铺文件的更新时间（ISO 8601格式）。
fileTypestring
店铺文件类型, css、gif、js、json、liquid、sv... 。
bash
curl -X GET \
https://{shop}.genmystore.com/api/202412/decoration/assets/{shopThemeId}" \
-H "X-Genstore-Access-Token: {access_token}" \json
HTTP/1.1 200 OK
{
"shopAssert": {
"createTime": "2024-18-12T08:18:49",
"context": "{\"color_scheme\":\"scheme-1\"}",
"updateTime": "2024-18-12T08:18:49",
"fileType": "json"
}
}关于 主题
访问范围
需要多个访问范围—请参阅每个端点以了解访问范围要求。
需要访问受保护的客户数据。
主题设计、上传修改 主题的能力，适用于自动化运营、定制主题开发。
主题 对象
主题业务域对象。
属性
POST 新增主题资产
更新店铺单个主题的主题资产。
访问范围
需要以下任意访问权限: write_themes
接口
POST /api/202412/themes/{theme_id}/assets
GET 获取主题列表
检索主题列表。
访问范围
需要以下任意访问权限: read_themes
接口
GET /api/202412/decoration/themes
GET 获取主题资产
获取店铺的主题资产信息。
访问范围
需要以下任意访问权限: read_themes
接口
GET /api/202412/decoration/assets/{shopThemeId}