Forward API リファレンス。
Description
Streams the complete zip package for a specified Skill version. The response body is application/zip; clients should write the body directly to a file instead of attempting to deserialize it.
パス
GET /api/v1/forward/skills/{id}/versions/{version}/content
リクエストヘッダー
| ヘッダー | 必須 | 説明 |
|---|---|---|
Authorization | はい | Bearer <PAT または SAT> |
パス参数
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | はい | Skill ID。 |
version | string | Yes | Version number. Accepts a 16-digit Unix microsecond timestamp or a legacy incremental counter during migration. The literal latest is not supported and returns 400. See Legacy version-number compatibility. |
リクエスト例
レスポンス
HTTP 200 OK
The response body is the complete zip archive byte stream.
| Response header | Example | Description |
|---|---|---|
Content-Type | application/zip | Fixed value |
Content-Disposition | attachment; filename="customer-reply.zip" | Suggested download filename, taken from directory in the Skill version object, which equals the Skill's name. |
Content-Length | 2607 | Matches content_size in the Skill version object. |
directory in the Skill version object. For example:
エラー
| HTTP | Type | 発生条件 |
|---|---|---|
| 400 | invalid_request_error | The version format is invalid, such as latest or a nonnumeric string. |
| 401 | authentication_error | 認証トークンがないか、無効です。 |
| 403 | permission_error | The caller cannot access the Skill. |
| 404 | not_found_error | The Skill or version does not exist. |
| 500/502/503 | api_error | Forward または依存サービスでエラーが発生しました。 |