Skip to main content

查询会话产物

千问办公企业旗舰版开发者文档:查询会话产物。

认证方式见APP开发者文档 → 认证接入。
  • 模块:会话服务(session)
  • 接口:GET/api/openapi/app/v1/sessions/{session_id}/output

请求参数

参数位置类型必填说明
session_idpathstring是创建会话接口返回的会话 ID。
cursorqueryinteger否文件列表分页游标,不解析内部含义;首次请求省略。
limitqueryinteger否文件列表每页数量。

响应

HTTP说明
200请求成功
default错误响应。按 code 判断具体错误,不能仅依赖 HTTP 状态码,多种错误可能共用状态码。
媒体类型:application/json。

响应200 SessionOutput

字段类型必填约束契约说明
degradedarray<string>是—本次未能读取的部分,例如对象存储不可用时返回 files;正常为空数组。若 files 为空且 degraded 包含 files,表示文件列表未知,不代表没有文件。
filesarray<OutputFile>是—会话输出目录中的文件,最新在前;没有时为空数组,不为 null。这些文件不标记所属回合;回合主动展示的文件另见回合详情。
has_moreboolean是—是否还有更多文件,仅描述 files 的分页。
liveLivePreview / null是—运行中应用的实时预览。实际投影返回对象,通过 live.available 判断是否可预览,不能预览时读取 live.reason。
next_cursorinteger是format="int64"下一页文件游标,没有下一页时为 0。仅对 files 分页;page、live 每页均完整返回。
pageOutputPage / null是—已发布页面,未发布时为 null。返回单个页面,重新发布产生新版本,URL 始终指向最新版本。

响应200 OutputFile

字段类型必填约束契约说明
created_atstring是ISO 8601 时间字符串存储系统记录的最近修改时间,ISO 8601,含微秒和时区。
mime_typestring否—存储系统提供的 MIME 类型;目录可省略。
namestring是—不含目录部分的名称,即 path 的最后一段。
pathstring是—存储路径,不是 URL。文件需按需换取下载链接,预签名链接会过期;目录则用此路径继续列举内容。
sizeinteger否format="int64"大小,单位字节;目录可能省略或为 0。
typestring是—file 表示文件,directory 表示目录。目录仅返回条目,不展开子项;按其路径继续查询。开放枚举,未知值不应导致整个列表处理失败。

LivePreview

字段类型必填说明
availableboolean是当前是否有可访问的实时预览;false 是正常状态,原因见 reason。
kindstring否预览类型,当前为 web_app;开放枚举。不可用时省略。
reasonstring否不可用原因:starting(启动中)、nothing_to_preview(无可预览应用)、preview_released(预览已释放)、session_ended(会话结束);开放枚举。
urlstring否短期预览地址,使用时重新查询,不作为永久链接保存。

OutputPage

字段类型必填说明
domainstring否发布页面所在域名。
published_atstring是当前版本发布时间,ISO 8601,含微秒和时区。
urlstring是发布页面的持久地址,始终指向最新发布版本。
versionstring否当前发布版本标识,再次发布产生新版本。

使用说明

创建会话绑定当前IAM用户;资源读取与变更按用户归属校验。写入发生超时或响应丢失时,不应假定服务端未接纳并盲目重复请求。