查询指定版本的元数据和扫描状态。
接口
GET /api/v1/skills/{skill_id}/versions/{version}
查询指定版本。版本号精确匹配,不回退到最新版本。
官方 Skill 仅可查询 active 版本,其他状态按版本不存在处理。已删除版本按不存在处理。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| skill_id | string | 是 | Skill ID |
| version | string | 是 | 版本号,例如 1.0 |
响应
返回 SkillVersionDTO。
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 版本记录唯一标识 |
| type | string | 固定为 skill_version |
| skill_id | string | 所属 Skill ID |
| display_name | string | 该版本的展示名称 |
| display_description | string | 该版本的展示描述 |
| version | string | 版本号 |
| status | string | 版本状态 |
| created_at | string | 创建时间 |
| updated_at | string | 更新时间 |
| additional_properties | object / null | 扩展属性;安全扫描未通过时包含 error_info |
示例
错误
| HTTP 状态码 | error_code | 说明 |
|---|---|---|
| 401 | WORKSPACE_ID_ILLEGAL | 身份信息缺失或无效 |
| 400 | SKILL_ID_IS_NULL | skill_id 为空白 |
| 400 | SKILL_VERSION_IS_NULL | version 为空白 |
| 500 | SKILL_NOT_EXIST | Skill 不存在、已删除或无权访问 |
| 500 | SKILL_VERSION_NOT_EXIST | 版本不存在、已删除或官方 Skill 的非 active 版本 |