ファイルのダウンロード

ファイルをダウンロードするには、取得するコンテンツが含まれるファイルのIDをGET /files/:id/contentに渡します。

curl -i -L -X GET "https://api.box.com/2.0/files/12345/content" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \

SDKを使用しない場合、このAPIコールでは、HTTP 302 Foundステータスコードとともに、次のようなダウンロードURLへのリンクを含むlocationヘッダーが返されます。

https://dl.boxcloud.com/d/1/[long-random-string]/download

cURLで-Lフラグを使用することで、自動的にこのリダイレクトに従うことができます。

SDKでは、結果として、バイナリデータがダウンロードされます。APIでは、ダウンロードURLがlocationヘッダーを介して返されます。

また、SDKを介してダウンロードURLを取得することも可能です。

このダウンロードURLは、ファイルのダウンロードを許可するためにユーザーのブラウザに渡すことができますが、このURLが期限切れになると、その後でダウンロードするには再度リクエストする必要があります。

ファイルをダウンロードする準備がまだできていない場合は、クライアントがファイルをダウンロードできるようになるまでの秒数を示すretry-afterヘッダーが返されます。

このレスポンスは、ダウンロードリクエストの直前にファイルがアップロードされた場合に発生することがあります。

ダウンロードURL