# 主题 API

> Shoplazza CLI 中 15 条底层主题 API 命令，用于管理主题、主题文件和主题版本，适合快捷命令不够用时使用。

主题管理的完整 API 命令。15 个 API 命令。

快捷命令工作流参见 [theme 快捷命令](./theme)。

所有主题 API 命令共享以下参数：

| 参数 | 短参 | 说明 |
|------|------|------|
| `--params` | | 路径/查询参数（JSON 格式） |
| `--data` | | 请求体（JSON 格式） |
| `--jq` | `-q` | jq 表达式过滤输出 |
| `--dry-run` | | 预览请求，不实际执行 |

## themes

```shell
shoplazza themes list
shoplazza themes get --params '{"theme_id":"123"}'
shoplazza themes delete --params '{"theme_id":"123"}'
shoplazza themes publish --data '{"theme_id":"123"}'
shoplazza themes upgrade --data @upgrade.json
shoplazza themes task --params '{"task_id":"123"}'
```

## themes file

管理主题文件。

```shell
shoplazza themes file tree --params '{"theme_id":"123"}'
shoplazza themes file get --params '{"theme_id":"123","key":"layout/theme.liquid"}'
shoplazza themes file create --params '{"theme_id":"123"}' --data @file.json
shoplazza themes file update --params '{"theme_id":"123"}' --data @file.json
shoplazza themes file delete --params '{"theme_id":"123","key":"assets/old.css"}'
shoplazza themes file rename --params '{"theme_id":"123"}' --data '{"old_key":"a.css","new_key":"b.css"}'
```

## themes version

管理主题版本。

```shell
shoplazza themes version list
shoplazza themes version records --params '{"version_id":"123"}'
shoplazza themes version get --params '{"version_id":"123"}'
```

## 相关

* [theme 快捷命令](./theme) — 简化的主题开发命令
* [主题 CLI 指南](/docs/theme/developer-tools/shoplazza-cli/) — 主题开发文档