Skip to main content

下载版本 ZIP

获取 Skill 版本 ZIP 包的临时下载地址,有效期 2 小时。

接口

GET /api/v1/skills/{skill_id}/versions/{version}/content 返回版本 ZIP 包的临时下载地址,不直接返回 ZIP 二进制流。版本号精确匹配,不回退到最新版本。 自定义 Skill 可以下载未删除的全部版本,包含 checking 和 rejected 状态;官方 Skill 仅可下载 active 版本。

请求参数

参数类型必填说明
skill_idstring是Skill ID
versionstring是版本号,例如 1.0

响应

返回 VersionDownloadResponse。
字段类型说明
skill_idstringSkill ID
versionstring版本号
file_urlstringZIP 包的预签名下载地址,有效期 2 小时
下载地址每次请求实时生成,过期后重新调用本接口获取。

示例

curl "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/skills/skill_abc123/versions/1.0/content" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "success": true,
  "error_code": null,
  "error_msg": null,
  "data": {
    "skill_id": "skill_abc123",
    "version": "1.0",
    "file_url": "https://example-bucket.oss-cn-beijing.aliyuncs.com/skills/pdf-skill-1.0.zip?Expires=...&Signature=..."
  },
  "request_id": "15a89d4c-f142-4e00-a9f7-b088442417c9"
}

错误

HTTP 状态码error_code说明
401WORKSPACE_ID_ILLEGAL身份信息缺失或无效
400SKILL_ID_IS_NULLskill_id 为空白
400SKILL_VERSION_IS_NULLversion 为空白
500SKILL_NOT_EXISTSkill 不存在、已删除或无权访问
500SKILL_VERSION_NOT_EXIST版本不存在、已删除或官方 Skill 的非 active 版本
500SYSTEM_ERROR下载地址生成失败