分页返回指定 Skill 的全部版本,按版本号降序排列。
GET /api/v1/cloud/skills/{skill_id}/versions
分页返回指定 Skill 的全部版本,按 version 降序排列(最新版本在最前)。
请求头
| 头部 | 必选 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
skill_id | string | 是 | Skill 的唯一标识符 |
查询参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
limit | integer | 否 | 每页返回数量上限。默认 20,最大 1000 |
page | string | 否 | 向后翻页游标;使用上一页响应的 next_page 值 |
示例请求
示例响应
HTTP 200 OK
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
data | array | Skill version 对象数组,按 version 降序 |
has_more | boolean | 是否还有更多记录(true 时使用 next_page 作为下一页的 page 值) |
next_page | string | null | 下一页向后游标;has_more 为 true 时传给 page |
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 版本唯一标识符 |
type | string | 资源类型,固定为 "skill_version" |
skill_id | string | 所属 Skill 的 ID |
version | string | 版本号 |
name | string | 该版本 SKILL.md frontmatter 中的 name |
description | string | 该版本 SKILL.md frontmatter 中的 description |
directory | string | Skill 目录名 |
created_at | string | 版本创建时间 |
content_size | integer | ⚠️ 已废弃:该版本 zip 文件大小(字节)(替代:无,将移除) |
content_sha256 | string | ⚠️ 已废弃:该版本内容的 SHA-256 哈希值(替代:无,将移除) |
status | string | ⚠️ 已废弃:版本状态 active(替代:无,将移除) |
updated_at | string | ⚠️ 已废弃:版本最后更新时间(版本不可变,替代:created_at) |
错误码
| HTTP | type | 触发条件 |
|---|---|---|
| 401 | authentication_error | 缺少或无效的认证令牌 |
| 404 | not_found_error | Skill 不存在或不再可访问 |
注意事项
- 每个版本是不可变的完整内容快照,通过 创建 Skill 版本 追加