查询 AI 卡片详情

GET 
/openapi/2026-01/themes/edit-sessions/:oseid/gen-blocks

返回 AI 卡片在当前会话中的文件信息和使用情况（是否已保存、被引用的次数等）；传 with_content=true 时附带卡片源码。

请求

Path参数

oseid string必填

编辑会话 ID

Query参数

type string

卡片的 card_type（blocks/ + 文件名去扩展名），如 blocks/gen_1a0d523

with_content boolean

为真时响应额外返回卡片源码 doc.content

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

doc object

文件本身的属性

idstring

这份文件在库里的 doc id（uuid）

typestring

文件目录，固定 blocks；card_type 由 type 与 location（去扩展名）拼接得到

locationstring

文件名，如 gen_1a0d523.liquid

hashstring

当前内容（编辑态视图口径）的 MD5

contentstring

卡片源码；仅 with_content=true 时返回

created_atstring

创建时间

updated_atstring

更新时间：当前这份内容最后被修改的时间

savedboolean

卡片是否已进入草稿环境（按 location 判在、不比对内容）

ref_countint32

主题内的实例引用数

instancesobject

引用明细，按容器键控：{ <容器 location（去后缀）>: [路径…] }。路径与编排接口 target 同一语法，一定落在某个 blocks 数组的下标上，如 1787800762db788e94.blocks.0、sections.1787800762db788e94.blocks.0

示例

json

{
  "code": "string",
  "message": "string",
  "data": {
    "doc": {
      "id": "string",
      "type": "string",
      "location": "string",
      "hash": "string",
      "content": "string",
      "created_at": "string",
      "updated_at": "string"
    },
    "saved": true,
    "ref_count": 0,
    "instances": {}
  }
}