複数のファイルやフォルダを1つのzip
アーカイブファイルとしてダウンロードするためのリクエストを作成します。このAPIでは、アーカイブは返されませんが、代わりにユーザーがすべての項目にアクセスできるかどうかを確認するチェックがすべて実行され、アーカイブのダウンロードに使用できるdownload_url
およびstatus_url
が返されます。
アーカイブの上限は、アカウントのアップロード上限または10,000ファイルのいずれかで、最初に達した上限が適用されます。
注: 大きいファイルをダウンロードする場合は、距離、ネットワーク遅延、帯域幅、輻輳のほか、パケット損失率や現在のサーバー負荷など、さまざまな要因の影響を受けることがあります。このような理由から、Boxでは、ZIPアーカイブの合計サイズが25 GBを超えないようにすることをお勧めします。
"January Financials"
zip
アーカイブの名前 (省略可)。この名前には、January Financials.zip
のように、.zip
というファイル拡張子が付加されます。
zip
アーカイブに追加する項目のリスト。項目にはファイルまたはフォルダを指定できます。
"12345"
アーカイブに追加する項目の識別子。この項目がフォルダの場合、IDが0
のルートフォルダを指定することはできません。
"file"
アーカイブに追加する項目の種類。
次の値のいずれか1つ: file
,folder
zip
アーカイブをダウンロードする準備ができている場合、このAPIによって、download_url
、status_url
のほか、リクエストの作成時に発生した可能性のある競合を含むレスポンスが返されます。
パラメータが不足しているか無効の場合はエラーを返します。
ほとんどの場合、このエラーは、JSONリクエスト本文が有効なJSONではないこと、項目のいずれかでIDが誤っているか指定されていないこと、いずれかの項目がファイルでもフォルダでもないこと、またはIDが0
のルートフォルダがアーカイブに追加するフォルダのリストに追加されたことが原因で発生する可能性があります。
以下は、このレスポンスに対する共通エラーコードのリストです。
bad_request
- リクエスト本文がないか無効である、またはファイルリストとフォルダリストの両方が空です。さらに、このエラーは、IDが0
のルートフォルダをアーカイブに追加しようとすると返される場合があります。zip_download_file_count_exceeded_limit
- リクエストされたファイルおよびフォルダによって、アーカイブのファイル数が10,000を超えます。アーカイブあたりのファイル数を減らすには、リクエストを複数のリクエストに分割する必要があります。zip_download_pre_compressed_bytes_exceeded_limit
- リクエストされたファイルおよびフォルダにより、アーカイブが、許可されたダウンロード上限を超えます。アーカイブのサイズを縮小するには、リクエストを複数のリクエストに分割する必要があります。Authorization
ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。
承認ヘッダーが指定されていても、ユーザーが項目にアクセスできない場合に返されます。
予期しないクライアントエラー。
curl -i -X POST "https://api.box.com/2.0/zip_downloads" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-d '{
"download_file_name": "January Financials",
"items": [
{
"type": "file",
"id": "12345"
},
{
"type": "file",
"id": "34325"
},
{
"type": "folder",
"id": "45678"
}
]
}'
{
"download_url": "https://dl.boxcloud.com/2.0/zip_downloads/29l00nfxDyHOt7RphI9zT_w==nDnZEDjY2S8iEWWCHEEiptFxwoWojjlibZjJ6geuE5xnXENDTPxzgbks_yY=/content",
"expires_at": "2020-07-22T11:26:08Z",
"name_conflicts": [
[
{
"download_name": "3aa6a7.pdf",
"id": "12345",
"original_name": "Report.pdf",
"type": "file"
},
{
"download_name": "5d53f2.pdf",
"id": "34325",
"original_name": "Report.pdf",
"type": "file"
}
]
],
"status_url": "https://api.box.com/2.0/zip_downloads/29l00nfxDyHOt7RphI9zT_w==nDnZEDjY2S8iEWWCHEEiptFxwoWojjlibZjJ6geuE5xnXENDTPxzgbks_yY=/status"
}