跳到主要内容
版本:202601

查询编辑会话卡片库

GET 

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

返回主题里可用的卡片:普通卡片(card_listblock_list)取已发布的版本;AI 卡片单独放在 gen_list,含会话中新建、还没放到页面或还没保存的卡片,每项带 saved 表示是否已保存到草稿。

请求

Path参数

    oseid string必填

    编辑会话 ID

Query参数

    need_schema int32

    传 1 时 section 卡片额外返回 schemasettings 字段

响应

OK

数据结构
    codestring

    错误码

    messagestring

    错误信息

    data object
    card_list object[]

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

  • Array [
  • group_keyint32

    分组序号,从 1 开始

    group_namestring

    分组名称,取自卡片分类

    groupsobject[]

    该分组下的卡片;每项含 typenameicontemplateslimit 与 schema 的透传字段,AI 卡片额外带 saved,传了 need_schema 时还带 schemasettings

  • ]
  • block_list object[]

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

  • Array [
  • group_keyint32

    分组序号,从 1 开始

    group_namestring

    分组名称,取自卡片分类

    groupsobject[]

    该分组下的卡片;每项含 typenameicontemplateslimit 与 schema 的透传字段,AI 卡片额外带 saved,传了 need_schema 时还带 schemasettings

  • ]
  • gen_list object[]

    AI 卡片,编辑态视图(含未落位、未保存的卡片);每项带 saved(是否已进入草稿环境)

  • Array [
  • group_keyint32

    分组序号,从 1 开始

    group_namestring

    分组名称,取自卡片分类

    groupsobject[]

    该分组下的卡片;每项含 typenameicontemplateslimit 与 schema 的透传字段,AI 卡片额外带 saved,传了 need_schema 时还带 schemasettings

  • ]