**版本：202601**

# 查询公共卡片列表

**GET** `/openapi/2026-01/themes/public-blocks`

返回某模板、主题下可用的公共卡片列表。

## 请求

**Query参数**

- `template` string

  按模板过滤公共卡片，如 index
- `theme` string

  主题名，如 Nova 2023
- `limit` int32

  可选，返回数量上限

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `apps` object[]

    应用及其公共卡片列表

    *   Array \[

    - `id` string

      应用 ID（如 public）
    - `blocks` object[]

      公共卡片。每项是卡片 schema 对象（`type`、`name` 等），结构不由本 API 固定
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "apps": [
      {
        "id": "string",
        "blocks": [
          {}
        ]
      }
    ]
  }
}
```