Forward Skill 版本 API 接口说明。
描述
以流式方式下载指定 Skill 版本的完整 zip 包内容。响应体是 application/zip，客户端应直接把 body 落到文件而不是尝试反序列化。
路径
GET /api/v1/forward/skills/{id}/versions/{version}/content
请求头
| 头部 | 必选 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
id | string | 是 | Skill ID。 |
version | string | 是 | 版本号；接受 16 位 Unix 微秒时间戳或过渡期的老递增计数器。字面量 latest 不受支持，返回 400。详见 老版本编号兼容。 |
示例请求
响应
HTTP 200 OK
响应体是完整的 zip 包字节流。
| 响应头 | 示例 | 说明 |
|---|---|---|
Content-Type | application/zip | 固定值 |
Content-Disposition | attachment; filename="customer-reply.zip" | 建议下载文件名，取自 Skill 版本对象 的 directory（等于 SKILL 的 name）。 |
Content-Length | 2607 | 与 Skill 版本对象 的 content_size 一致。 |
directory 字段一致，示例结构：
错误码
| 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 或依赖服务失败。 |