Skip to main content

获取版本详情

查询指定版本的元数据和扫描状态。

接口

GET /api/v1/skills/{skill_id}/versions/{version} 查询指定版本。版本号精确匹配,不回退到最新版本。 官方 Skill 仅可查询 active 版本,其他状态按版本不存在处理。已删除版本按不存在处理。

请求参数

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

响应

返回 SkillVersionDTO。
字段类型说明
idstring版本记录唯一标识
typestring固定为 skill_version
skill_idstring所属 Skill ID
display_namestring该版本的展示名称
display_descriptionstring该版本的展示描述
versionstring版本号
statusstring版本状态
created_atstring创建时间
updated_atstring更新时间
additional_propertiesobject / null扩展属性;安全扫描未通过时包含 error_info

示例

curl "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/skills/skill_abc123/versions/1.0" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "success": true,
  "error_code": null,
  "error_msg": null,
  "data": {
    "id": "skillver_xxxxxxxxxxxxxxxxxxxxxx",
    "type": "skill_version",
    "skill_id": "skill_abc123",
    "display_name": "My Custom Skill",
    "display_description": "从 SKILL.md 解析的描述",
    "version": "1.0",
    "status": "checking",
    "created_at": "2026-06-15T08:23:11Z",
    "updated_at": "2026-06-15T08:23:11Z",
    "additional_properties": null
  },
  "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 版本