GET /v1/files/{file_id}/content
ファイルコンテンツリンクを返します。返される URL は有効期限付きで、ファイル内容を直接ダウンロードできます。
ファイルのダウンロードは status が ready の場合のみ可能です。
ヘッダー
| ヘッダー | 必須 | 説明 |
|---|---|---|
| Authorization | はい | Bearer $QODER_PAT |
パスパラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
file_id | string | はい | ファイル ID(file_ プレフィックス) |
リクエスト例
レスポンス例
HTTP 200 OKレスポンスフィールド
| フィールド | 型 | 説明 |
|---|---|---|
url | string | 署名済みダウンロード URL |
expires_at | string | URL の有効期限(RFC 3339 形式の UTC) |
注意事項
expires_at以降は新しい URL を再リクエストしてください。- クライアントは JSON レスポンスから
urlフィールドを読み取り、その URL に GET リクエストを送信してファイル内容をダウンロードしてください。
エラーレスポンス
| HTTP | type | 説明 |
|---|---|---|
| 401 | authentication_error | 認証トークンが欠落または無効 |
| 403 | permission_error | ファイル用途がダウンロード非対応 |
| 404 | not_found_error | 指定 ID のファイルが存在しない |
| 409 | conflict_error | ファイルは存在するが ready ステータスではない |
| 410 | not_found_error | ファイルが deleted ステータス |
関連項目
ファイルの添付とダウンロード
Agent にコンテキストを提供するファイルをアップロードし、Agent が生成したファイルをダウンロードします。