メインコンテンツへスキップ
分割アップロードの最後の手順はセッションのコミットです。 ファイルアップロードセッションをコミットするには、コミットするアップロード済みパーツのリストを指定してを呼び出します。
加えて、ファイルのattributesをpartsとともに渡すことで、ファイルに情報を追加できます。詳細については、 APIを参照してください。

計画済みパーツのコミット

には、partsリストに以下の両方を含める必要があります。
  • アップロードしたパーツ。これには、それぞれののレスポンスを使用します。
  • 計画のレスポンスに含まれるhits。これには、各ヒットのpart_id、offset、sizeを使用します。
Boxでは、パーツがファイル全体を隙間なく網羅しているかどうか、バイト0からファイル末尾までを確認します。また、各計画済みパーツが計画リクエストで送られたサイズおよびSHA-512ハッシュと一致しているかどうかも確認します。

パーツのハッシュ

partsの各エントリには、sha1またはsha512のハッシュを含めることができます。sha512はすべてのエントリに含めるか、そうでなければどのエントリにも含めないようにします。一部のエントリにのみsha512が含まれている場合、APIはコードinvalid_parts_fieldの400 Bad Requestエラーを返します。 を使用して、サーバーにすでに存在するパーツをスキップした場合は、それらの各パーツも、他のパーツと同様にpartsに含めます。planレスポンス内のhitsから、part_id、offset、sizeの値を使用します。そのうえで、以下のようにします。
  • 他のエントリにsha512が含まれている場合は、planレスポンスからsha512の値を含めます。
  • 他のエントリにsha1が含まれている場合、またはハッシュが含まれていない場合は、これらのエントリにはハッシュを含めません。
ファイル全体に対するdigestヘッダーでサポートされるのは、SHA-1のみです。これは、SHA-512ダイジェストを使用してパーツをアップロードした場合も同様です。

レスポンス

成功すると、APIはHTTP 201 Createdステータスコードとオブジェクトを返します。 場合によっては、パーツの作成がまだ準備できておらず、代わりに202 Acceptedステータスコードが返されることがあります。この場合、アプリケーションはretry-afterヘッダーを確認し、指定された秒数後にコミットを再試行する必要があります。
最終更新日 2026年11月4日