メインコンテンツへスキップ
GET /v1/files/{file_id}/content ファイルコンテンツリンクを返します。返される URL は有効期限付きで、ファイル内容を直接ダウンロードできます。 ファイルのダウンロードは statusready の場合のみ可能です。

ヘッダー

ヘッダー必須説明
AuthorizationはいBearer $QODER_PAT

パスパラメータ

パラメータ必須説明
file_idstringはいファイル ID(file_ プレフィックス)

リクエスト例

curl -X GET "https://api.qoder.com/api/v1/cloud/files/file_019e3bb9b0c2752688aeb5fdacf00565/content" \
  -H "Authorization: Bearer $QODER_PAT"

レスポンス例

HTTP 200 OK
{
  "expires_at": "2026-05-18T16:34:52Z",
  "url": "https://storage.qoder.com/files/..."
}

レスポンスフィールド

フィールド説明
urlstring署名済みダウンロード URL
expires_atstringURL の有効期限(RFC 3339 形式の UTC)

注意事項

  • expires_at 以降は新しい URL を再リクエストしてください。
  • クライアントは JSON レスポンスから url フィールドを読み取り、その URL に GET リクエストを送信してファイル内容をダウンロードしてください。

エラーレスポンス

HTTPtype説明
401authentication_error認証トークンが欠落または無効
403permission_errorファイル用途がダウンロード非対応
404not_found_error指定 ID のファイルが存在しない
409conflict_errorファイルは存在するが ready ステータスではない
410not_found_errorファイルが deleted ステータス
エラーで完全なエラーエンベロープを参照してください。

関連項目

ファイルの添付とダウンロード

Agent にコンテキストを提供するファイルをアップロードし、Agent が生成したファイルをダウンロードします。