下载运行绑定技能文件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
参数 |
类型 |
说明 |
|---|---|---|
|
string |
必须与已验证运行声明一致。 |
|
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封套,也不是单文件明文。 |
|
HTTP header |
实际冻结版本;示例7不是调用者选择值。 |
文件来源 |
协议行为 |
按冻结版本读取并校验文件路径、大小和摘要;当前版本更新不替换该快照。 |
错误响应¶
声明缺失、未绑定、来源/版本/工作区不合法或有查询参数时可403;找不到冻结版本/文件可404;技能错误沿当前映射处理。不能用普通PAT下载成功的mock替代真实准入。
最后更新于