Copy

描述

根据版本号获取单个 Skill 版本的元信息（不含内容，内容通过下载 Skill 版本内容拉取）。

路径

GET /api/v1/forward/skills/{id}/versions/{version}

请求头

头部	必选	说明
`Authorization`	是	`Bearer <PAT 或 SAT>`

路径参数

参数	类型	必选	说明
`id`	string	是	Skill ID。
`version`	string	是	版本号。 • 推荐：16 位 Unix 微秒时间戳（如 `1759178010641129`）； • 兼容：过渡期的老递增计数器（如 `"1"`、`"2"`）仍可命中同一版本。字面量 `latest` 不受支持，返回 400；请先调用查询 Skill 读取 `latest_version` 字段拿到最新版本号再拼路径。

示例请求

curl -X GET "https://api.qoder.com/api/v1/forward/skills/skill_xxx/versions/1786973491821648" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

老编号兼容示例：

curl -X GET "https://api.qoder.com/api/v1/forward/skills/skill_xxx/versions/2" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

示例响应

HTTP 200 OK

{
  "id": "skillver_xxx",
  "skill_id": "skill_xxx",
  "version": "1786973491821648",
  "name": "customer-reply",
  "description": "Customer reply skill",
  "directory": "customer-reply",
  "content_size": 2607,
  "content_sha256": "9de8ae3a296bc6198cd080f5ce31d523a34fd0a52e2e64365055fa79a0d3383d",
  "status": "active",
  "created_at": "2026-08-17T13:31:31.917881Z",
  "metadata": {}
}

响应字段

响应为 Skill 版本对象。老版本编号兼容规则详见老版本编号兼容。

错误码

HTTP	type	触发条件
400	`invalid_request_error`	版本号格式非法（例如传入 `latest` 或非数字字符串）。
401	`authentication_error`	缺少或无效的认证令牌。
403	`permission_error`	当前调用方无权访问该 Skill。
404	`not_found_error`	Skill 或版本不存在。
500/502/503	`api_error`	Forward 或依赖服务失败。

​描述

​路径

​请求头

​路径参数

​示例请求

​示例响应

​响应字段

​错误码

描述

路径

请求头

路径参数

示例请求

示例响应

响应字段

错误码