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。详见 老版本编号兼容。 |
查询参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
identity_id | string | 否 | 仅在操作 Identity 归属资源时使用；PAT 可通过 Query 显式传入，不传时为管理员视角；SAT 由凭证确定归属，任何 SAT 显式携带该参数（包括空值）返回 HTTP 400。版本继承所属 Skill 的归属，详见 Identity 归属。 |
示例请求
响应
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 或非数字字符串），或 SAT 显式携带 Query identity_id（含空值）。 |
| 401 | authentication_error | 缺少或无效的认证令牌。 |
| 403 | permission_error | 管理员 Scope 发生 Owner mismatch，或下游服务拒绝访问。 |
| 404 | not_found_error | Skill/版本不存在或在当前 Identity Scope 不可见；PAT 指定的 Identity 无效、已禁用、已删除或越权。 |
| 500/502/503 | api_error | Forward 或依赖服务失败。 |