**版本：202601**

# 安装市场主题

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

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

## 请求

**Path参数**

- `remote_theme_id` string (required)

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

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `name` string

  主题显示名
- `default` boolean

  设为店铺默认主题
- `preset` string

  样式预设名（取自市场主题的 presets）
- `version` string

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

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

  安装后的主题在商家后台中隐藏
- `ext_suffix` string

  追加到扩展主题名称后的后缀；建议不超过 15 个字符
- `product_id_map` object[]

  商品 id 映射
- `collection_id_map` object[]

  专辑 id 映射
- `page_id_map` object[]

  自定义页面 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**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `data` object

    安装后的主题

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