下载运行绑定技能文件ZIP

下载当前可信运行冻结的技能版本文件。版本来自验证后的运行声明,不是URL参数或技能当前版本。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/skills/{skill_id}/runtime-files

调用前准备

MOI_ENDPOINT 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。

仅适用于已经由产品准入的子运行环境。使用该环境一起提供的Endpoint、技术API Key、工作区和X-MOI-Runtime-Authorization;后者为完整Bearer行,不用个人访问令牌或浏览器短期证明替代。

请求参数

curl --fail-with-body "$MOI_ENDPOINT/workspaces/$MOI_WORKSPACE_ID/skills/$SKILL_ID/runtime-files" \
  -H "X-API-Key: $MOI_API_KEY" \
  -H "X-Workspace-ID: $MOI_WORKSPACE_ID" \
  -H "X-MOI-Runtime-Authorization: $MOI_RUNTIME_AUTHORIZATION" \
  --output skill-files.zip

参数

类型

说明

workspace_id

string

必须与已验证运行声明一致。

skill_id

string

声明中绑定且有唯一正版本的技能。

查询参数

不接受

RawQuery非空会被拒绝,不能传version或来源工作区。

运行声明

受信上下文

绑定、来源仅当前工作区或system、唯一冻结版本由后端确认。

成功响应

HTTP/1.1 200 OK
Content-Type: application/zip
Content-Disposition: attachment; filename=skill-files.zip
X-MOI-Skill-Version: 7
Cache-Control: private, no-store
X-Content-Type-Options: nosniff

<ZIP二进制字节>

字段或响应项

类型

说明

响应体

ZIP字节

不是JSON封套,也不是单文件明文。

X-MOI-Skill-Version

HTTP header

实际冻结版本;示例7不是调用者选择值。

文件来源

协议行为

按冻结版本读取并校验文件路径、大小和摘要;当前版本更新不替换该快照。

错误响应

声明缺失、未绑定、来源/版本/工作区不合法或有查询参数时可403;找不到冻结版本/文件可404;技能错误沿当前映射处理。不能用普通PAT下载成功的mock替代真实准入。

最后更新于