简体中文

English

简体中文

English

关于 主题 ​

访问范围

需要多个访问范围—请参阅每个端点以了解访问范围要求。

需要访问受保护的客户数据。

主题设计、上传修改 主题的能力，适用于自动化运营、定制主题开发。

接口

GET /api/202412/themes: 查询主题列表

GET /api/202412/themes/{themeId}/assets: 查询主题资产

主题 对象 ​

一个商店最多可以拥有 20 个主题，其中只有一个是已发布主题，顾客在访问商店时看到的就是这个主题。 主题包内包含众多 Asset（资产）资源。 如果你想更新主题包或者主题包内资产，可以上传修改后主题包或者更新Asset（资产）资源文件。

属性 ​

themeobjectrequired
主题列表。
- 收起属性
isCurrentbooleanrequired
店铺是否当前主题标识, true 是, false 否。
shopThemeNamestringrequired
商户主题名称。
createTimestringrequired
店铺主题创建时间（ISO 8601格式）。
shopThemeIdstringrequired
商户主题ID。
updateTimestringrequired
店铺主题更新时间（ISO 8601格式）。
statusstringrequired
安装状态,枚举 ：INIT 初始化, SUCCESS 成功, FAIL 失败。
bash
{
  "theme": {
    "isCurrent": "false",
    "shopThemeName": "Down",
    "createTime": "2024-18-12T08:18:49Z",
    "shopThemeId": "1",
    "updateTime": "2024-18-12T08:18:49Z",
    "status": "INIT"
  }
}

GET 查询主题列表 ​

检索主题列表。

访问范围

需要以下任意访问权限: read_themes

接口

GET /api/202412/themes 

请求参数

{}

响应数据

themesarrayrequired
主题列表。
- 收起属性
isCurrentbooleanrequired
店铺是否当前主题标识, true 是, false 否。
shopThemeNamestringrequired
商户主题名称。
createTimestringrequired
店铺主题创建时间（ISO 8601格式）。
shopThemeIdstringrequired
商户主题ID。
updateTimestringrequired
店铺主题更新时间（ISO 8601格式）。
statusstringrequired
安装状态,枚举 ：INIT - 初始化, SUCCESS - 成功, FAIL - 失败。
bash
curl -X GET \ 
https://{shop}.genmystore.com/api/202412/themes" \ 
-H "X-Genstore-Access-Token: {access_token}" \
json
HTTP/1.1 200 OK
{
  "themes": [
    {
      "isCurrent": "false",
      "shopThemeName": "Down",
      "createTime": "2025-01-10T11:00:00Z",
      "shopThemeId": "1",
      "updateTime": "2025-01-10T11:00:00Z",
      "status": "INIT"
    }
  ]
}

GET 查询主题资产 ​

获取店铺的主题资产信息。

访问范围

需要以下任意访问权限: read_themes

接口

GET /api/202412/themes/{themeId}/assets 

请求参数

assetNamestringrequired
店铺主题的资源地址。
themeIdstringrequired
店铺主题的唯一标识。

响应数据

assetobjectrequired
店铺的资产信息。
- 收起属性
createTimestringrequired
店铺文件的创建时间（ISO 8601格式）。
contextstringrequired
店铺文件内容。
updateTimestringrequired
店铺文件的更新时间（ISO 8601格式）。
fileTypestringrequired
店铺文件类型, css、gif、js、json、liquid、sv... 。
bash
curl -X GET \ 
https://{shop}.genmystore.com/api/202412/themes/{themeId}/assets" \ 
-H "X-Genstore-Access-Token: {access_token}" \
json
HTTP/1.1 200 OK
{
  "asset": {
    "createTime": "2025-01-10T11:00:00Z",
    "context": "{\"color_scheme\":\"scheme-1\"}",
    "updateTime": "2025-01-10T11:00:00Z",
    "fileType": "json"
  }
}