**版本：202601**

# 查询编辑会话卡片库

**GET** `/openapi/2026-01/themes/edit-sessions/:oseid/card-list`

返回主题里可用的卡片：普通卡片（`card_list`、`block_list`）取已发布的版本；AI 卡片单独放在 `gen_list`，含会话中新建、还没放到页面或还没保存的卡片，每项带 `saved` 表示是否已保存到草稿。

## 请求

**Path参数**

- `oseid` string (required)

  编辑会话 ID

**Query参数**

- `need_schema` int32

  传 1 时 section 卡片额外返回 `schema` 和 `settings` 字段

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `card_list` object[]

    普通 section 卡片，发布态数据——结构与存量 cardList 接口一致

    *   Array \[

    - `group_key` int32

      分组序号，从 1 开始
    - `group_name` string

      分组名称，取自卡片分类
    - `groups` object[]

      该分组下的卡片；每项含 `type`、`name`、`icon`、`templates`、`limit` 与 schema 的透传字段，AI 卡片额外带 `saved`，传了 `need_schema` 时还带 `schema` 与 `settings`
    *   \]
  - `block_list` object[]

    普通 block 卡片，发布态数据——结构与存量 cardList 接口一致

    *   Array \[

    - `group_key` int32

      分组序号，从 1 开始
    - `group_name` string

      分组名称，取自卡片分类
    - `groups` object[]

      该分组下的卡片；每项含 `type`、`name`、`icon`、`templates`、`limit` 与 schema 的透传字段，AI 卡片额外带 `saved`，传了 `need_schema` 时还带 `schema` 与 `settings`
    *   \]
  - `gen_list` object[]

    AI 卡片，编辑态视图（含未落位、未保存的卡片）；每项带 `saved`（是否已进入草稿环境）

    *   Array \[

    - `group_key` int32

      分组序号，从 1 开始
    - `group_name` string

      分组名称，取自卡片分类
    - `groups` object[]

      该分组下的卡片；每项含 `type`、`name`、`icon`、`templates`、`limit` 与 schema 的透传字段，AI 卡片额外带 `saved`，传了 `need_schema` 时还带 `schema` 与 `settings`
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "card_list": [
      {
        "group_key": 0,
        "group_name": "string",
        "groups": [
          {}
        ]
      }
    ],
    "block_list": [
      {
        "group_key": 0,
        "group_name": "string",
        "groups": [
          {}
        ]
      }
    ],
    "gen_list": [
      {
        "group_key": 0,
        "group_name": "string",
        "groups": [
          {}
        ]
      }
    ]
  }
}
```