安装市场主题

POST 
/openapi/2026-01/themes/merchant-themes/:remote_theme_id/install

按市场主题 id 把主题安装到当前店铺。支持指定主题名称与样式预设，并可设为店铺默认主题；店铺还没有默认主题时，安装的主题会自动设为默认主题。

请求

Path参数

remote_theme_id string必填

要安装的市场主题的远端主题 id

application/json

请求体

请求体必填

namestring

主题显示名

defaultboolean

设为店铺默认主题

presetstring

样式预设名（取自市场主题的 presets）

versionstring

要安装的主题版本；不传时安装该市场主题的当前版本（c_version）

sourcesstring

记录在已安装主题上的业务来源标记。与复制主题接口的 sources（复制范围）无关

admin_hiddenboolean

安装后的主题在商家后台中隐藏

ext_suffixstring

追加到扩展主题名称后的后缀；建议不超过 15 个字符

product_id_mapobject[]

商品 id 映射

collection_id_mapobject[]

专辑 id 映射

page_id_mapobject[]

自定义页面 id 映射

示例

json

{
  "name": "string",
  "default": true,
  "preset": "string",
  "version": "string",
  "sources": "string",
  "admin_hidden": true,
  "ext_suffix": "string",
  "product_id_map": [
    {}
  ],
  "collection_id_map": [
    {}
  ],
  "page_id_map": [
    {}
  ]
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

dataobject

安装后的主题

示例

json

{
  "code": "string",
  "message": "string",
  "data": {
    "data": {}
  }
}