Forward Skill 版本 API 接口说明。
描述
列出指定 Skill 的所有版本,按 created_at 倒序返回,支持游标分页。版本一经创建后不可变。
路径
GET /api/v1/forward/skills/{id}/versions
请求头
| 头部 | 必选 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
id | string | 是 | Skill ID。 |
查询参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
limit | integer | 否 | 分页大小,最大 100,默认 20。 |
page | string | 否 | 向后翻页游标;取值来自上一页响应的 next_page;不传即从第一页开始。 |
示例请求
示例响应
HTTP 200 OK
响应字段
响应 data 数组每一项为 Skill 版本对象。分页字段(has_more / next_page)详见 Skill 版本列表分页字段。
错误码
| HTTP | type | 触发条件 |
|---|---|---|
| 400 | invalid_request_error | limit 或 page 参数非法。 |
| 401 | authentication_error | 缺少或无效的认证令牌。 |
| 403 | permission_error | 当前调用方无权访问该 Skill。 |
| 404 | not_found_error | Skill 不存在或不可见。 |
| 500/502/503 | api_error | Forward 或依赖服务失败。 |