アップロードセッションを作成

post
https://upload.box.com/api/2.0
/files/upload_sessions

新しいファイルのアップロードセッションを作成します。

リクエスト

application/json

リクエスト本文

string本文内必須
Project.mov

新規ファイルの名前

integer / int64本文内必須
104857600

アップロードされるファイルの合計バイト数

string本文内必須
0

新しいファイルのアップロード先フォルダのID。

レスポンス

新しいアップロードセッションを返します。

一部のパラメータが指定されていないか無効な場合はエラーを返します。

  • missing_destination: folder_idが指定されていません
  • invalid_folder_id: folder_idが無効です
  • invalid_file_name: file_nameが無効です
  • missing_file_size: file_sizeが指定されていません
  • invalid_file_size: file_sizeが有効な数値ではありません
  • file_size_too_small: file_sizeが、このAPIを介したアップロードの最小ファイルサイズを下回っています
  • missing_file_name: file_nameが指定されていません

ファイルがすでに存在する場合、またはアカウントのディスク容量が不足している場合は、エラーを返します。

予期しないクライアントエラー。

post
アップロードセッションを作成
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

cURL
curl -X POST https://upload.box.com/api/2.0/files/upload_sessions \
     -H 'Authorization: Bearer <ACCESS_TOKEN>" '
     -H 'Content-Type: application/json" '
     -d '{
       "folder_id": "0",
       "file_size": 104857600,
       "file_name": "Project.mov"
     }'
Java
BoxFileUploadSession.Info sessionInfo;
if (/* uploading a new file */) {
    // Create the upload session for a new file
    BoxFolder rootFolder = BoxFolder.getRootFolder(api);
    sessionInfo = rootFolder.createUploadSession("New Large File.pdf", fileSize);
} else if (/* uploading a new version of an exiting file */) {
    // Create the uplaod session for a new version of an existing file
    String fileID = "93465";
    BoxFile file = new BoxFile(api, fileID);
    sessionInfo = file.createUploadSession(fileSize);
}

//Get the session resource from the session info
BoxFileUploadSession session = sessionInfo.getResource();

//Create the Message Digest for the whole file
MessageDigest digest = null;
try {
    digest = MessageDigest.getInstance("SHA1");
} catch (NoSuchAlgorithmException ae) {
    throw new BoxAPIException("Digest algorithm not found", ae);
}
Python
file_size = 26000000
file_name = 'test_file.pdf'
upload_session = client.folder('22222').create_upload_session(file_size, file_name)
print('Created upload session {0} with chunk size of {1} bytes'.format(upload_session.id, upload_session.part_size))
Node
// Create a session to upload a 2GB file "huge.pdf" into folder 12345
client.files.createUploadSession('12345', 2147483648, 'huge.pdf', callback);