Skip to main content
Versions

列表 Skill 版本

分页返回指定 Skill 的全部版本,按版本号降序排列。

GET /api/v1/cloud/skills/{skill_id}/versions 分页返回指定 Skill 的全部版本,按 version 降序排列(最新版本在最前)。

请求头

头部必选说明
AuthorizationBearer <PAT 或 SAT>

路径参数

参数类型必选说明
skill_idstringSkill 的唯一标识符

查询参数

参数类型必选说明
limitinteger每页返回数量上限。默认 20,最大 1000
pagestring向后翻页游标;使用上一页响应的 next_page

示例请求

curl -X GET "https://api.qoder.com/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d/versions?limit=20" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

示例响应

HTTP 200 OK
{
  "data": [
    {
      "id": "skillver_019e3bbb6a25768b9b50ca2f52aa4345",
      "type": "skill_version",
      "skill_id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
      "version": "1759264410332875",
      "name": "my-custom-skill",
      "description": "自定义 Skill 示例(第二版)",
      "directory": "my-custom-skill",
      "created_at": "2026-05-19T10:12:07.332875Z"
    },
    {
      "id": "skillver_019e3bba474b7f10a3c2b4d5e6f70123",
      "type": "skill_version",
      "skill_id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
      "version": "1759178010641129",
      "name": "my-custom-skill",
      "description": "自定义 Skill 示例",
      "directory": "my-custom-skill",
      "created_at": "2026-05-18T15:35:24.248164Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

响应字段

字段类型说明
dataarraySkill version 对象数组,按 version 降序
has_moreboolean是否还有更多记录(true 时使用 next_page 作为下一页的 page 值)
next_pagestring | null下一页向后游标;has_moretrue 时传给 page
Skill version 对象:
字段类型说明
idstring版本唯一标识符
typestring资源类型,固定为 "skill_version"
skill_idstring所属 Skill 的 ID
versionstring版本号
namestring该版本 SKILL.md frontmatter 中的 name
descriptionstring该版本 SKILL.md frontmatter 中的 description
directorystringSkill 目录名
created_atstring版本创建时间
content_sizeinteger⚠️ 已废弃:该版本 zip 文件大小(字节)(替代:无,将移除)
content_sha256string⚠️ 已废弃:该版本内容的 SHA-256 哈希值(替代:无,将移除)
statusstring⚠️ 已废弃:版本状态 active(替代:无,将移除)
updated_atstring⚠️ 已废弃:版本最后更新时间(版本不可变,替代:created_at

错误码

HTTPtype触发条件
401authentication_error缺少或无效的认证令牌
404not_found_errorSkill 不存在或不再可访问

注意事项

完整错误信封说明详见 错误参考

相关