メインコンテンツまでスキップ

API を使用してファイルをダウンロードする方法

概要​

お客様のシステムや外部のシステムがカスタムストレージに保存されたファイルを安全にダウンロードするための API です。
安全な M2M（Machine-to-Machine）認証により署名付き URL を発行し、15 分間有効なファイルアクセス権を提供します。

事前準備​

1. API キーの生成​

「API キー生成」画面で Client ID と Client Secret を生成し、安全に保管してください。

2. IP アドレス制限（任意）​

必要に応じてIP アドレス制限を設定できます。
設定しない場合は、すべての IP アドレスからのアクセスが許可されます。

API 仕様​

エンドポイント​

POST https://asia-northeast1-combofun-production.cloudfunctions.net/auth-storagedownload

リクエスト​

{
  "clientId": "valid-client-id",
  "clientSecret": "valid-client-secret",
  "fileName": "target-file.csv"
}

レスポンス​

成功時（200）

{
  "url": "https://storage.googleapis.com/..."
}

エラー時

  • 400: パラメータ不正
  • 403: IP 制限または認証失敗
  • 404: ファイルが存在しない
  • 500: サーバーエラー

使用手順​

1. API 呼び出し​

バックエンドシステムから Client ID と Client Secret を使用してリクエストを送信します。

2. ファイルダウンロード​

返された署名付き URL を使用してファイルを直接ダウンロードします。

使用例​

curl を用いた API リクエストの例
curl -i https://asia-northeast1-combofun-production.cloudfunctions.net/auth-storagedownload \
-H "Content-Type: application/json" \
-d '{
"clientId":"valid-client-id",          # 実際のクライアントIDに置き換えてください
"clientSecret":"valid-client-secret",  # 実際のクライアントシークレットに置き換えてください
"fileName":"target-file.csv"           # ダウンロード対象のファイル名に置き換えてください
}'

注意事項​

  • ファイル範囲: テナントに紐づくカスタムストレージのファイルのみアクセス可能
  • 有効期限: 15 分間
備考

ファイルのアップロードについてはカスタムストレージ機能を参照してください。