千问办公企业旗舰版开发者文档:查询会话产物。
认证方式见APP开发者文档 → 认证接入。
媒体类型:
创建会话绑定当前IAM用户;资源读取与变更按用户归属校验。写入发生超时或响应丢失时,不应假定服务端未接纳并盲目重复请求。
- 模块:会话服务(session)
- 接口:GET
/api/openapi/app/v1/sessions/{session_id}/output
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| session_id | path | string | 是 | 创建会话接口返回的会话 ID。 |
| cursor | query | integer | 否 | 文件列表分页游标,不解析内部含义;首次请求省略。 |
| limit | query | integer | 否 | 文件列表每页数量。 |
响应
| HTTP | 说明 |
|---|---|
| 200 | 请求成功 |
| default | 错误响应。按 code 判断具体错误,不能仅依赖 HTTP 状态码,多种错误可能共用状态码。 |
application/json。
响应200 SessionOutput
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| degraded | array<string> | 是 | — | 本次未能读取的部分,例如对象存储不可用时返回 files;正常为空数组。若 files 为空且 degraded 包含 files,表示文件列表未知,不代表没有文件。 |
| files | array<OutputFile> | 是 | — | 会话输出目录中的文件,最新在前;没有时为空数组,不为 null。这些文件不标记所属回合;回合主动展示的文件另见回合详情。 |
| has_more | boolean | 是 | — | 是否还有更多文件,仅描述 files 的分页。 |
| live | LivePreview / null | 是 | — | 运行中应用的实时预览。实际投影返回对象,通过 live.available 判断是否可预览,不能预览时读取 live.reason。 |
| next_cursor | integer | 是 | format="int64" | 下一页文件游标,没有下一页时为 0。仅对 files 分页;page、live 每页均完整返回。 |
| page | OutputPage / null | 是 | — | 已发布页面,未发布时为 null。返回单个页面,重新发布产生新版本,URL 始终指向最新版本。 |
响应200 OutputFile
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| created_at | string | 是 | ISO 8601 时间字符串 | 存储系统记录的最近修改时间,ISO 8601,含微秒和时区。 |
| mime_type | string | 否 | — | 存储系统提供的 MIME 类型;目录可省略。 |
| name | string | 是 | — | 不含目录部分的名称,即 path 的最后一段。 |
| path | string | 是 | — | 存储路径,不是 URL。文件需按需换取下载链接,预签名链接会过期;目录则用此路径继续列举内容。 |
| size | integer | 否 | format="int64" | 大小,单位字节;目录可能省略或为 0。 |
| type | string | 是 | — | file 表示文件,directory 表示目录。目录仅返回条目,不展开子项;按其路径继续查询。开放枚举,未知值不应导致整个列表处理失败。 |
LivePreview
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| available | boolean | 是 | 当前是否有可访问的实时预览;false 是正常状态,原因见 reason。 |
| kind | string | 否 | 预览类型,当前为 web_app;开放枚举。不可用时省略。 |
| reason | string | 否 | 不可用原因:starting(启动中)、nothing_to_preview(无可预览应用)、preview_released(预览已释放)、session_ended(会话结束);开放枚举。 |
| url | string | 否 | 短期预览地址,使用时重新查询,不作为永久链接保存。 |
OutputPage
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| domain | string | 否 | 发布页面所在域名。 |
| published_at | string | 是 | 当前版本发布时间,ISO 8601,含微秒和时区。 |
| url | string | 是 | 发布页面的持久地址,始终指向最新发布版本。 |
| version | string | 否 | 当前发布版本标识,再次发布产生新版本。 |