アップロード前の事前チェック

options
https://api.box.com/2.0
/files/content

ファイル全体をアップロードする前に、ファイルがBoxで受け入れられるかどうかをチェックします。

リクエスト

Bearer [ACCESS_TOKEN]
application/json

リクエスト本文

string本文内省略可能
File.mp4

ファイルの名前

object本文内

ファイルのアップロード先の親フォルダ

stringnull省略可能
123

親項目のID

integer / int32本文内省略可能
1024

ファイルのサイズ(バイト単位)

レスポンス

application/jsonアップロードURL

チェックに合格した場合、応答にはファイルのアップロード先として使用できるセッションURLが含まれます。

application/json競合エラー

チェックに合格しなかった場合、応答にはその理由に関する詳細が含まれます。

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

options
アップロード前の事前チェック
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

cURL
curl -X OPTIONS https://api.box.com/2.0/files/content \
     -H 'Authorization: Bearer <ACCESS_TOKEN>'
     -H "Content-Type: multipart/form-data" \
     -F attributes='{"name":"Photo.jpg", "parent":{"id":"11446498"}}'
Java
String fileName = "My Doc.pdf";
BoxFolder rootFolder = BoxFolder.getRootFolder(api);
try {
    folder.canUpload(fileName, 98734576);

    // If the file upload would not have succeeded, it will not be attempted
    folder.uploadFile(fileContents, fileName);
} catch (BoxAPIException ex) (

)
Node
// Verify that uploading a 200MB file named "Preso.ppt" to folder 12345 would succeed
client.files.preflightUploadFile(
		'12345',
		{
			name: 'Preso.ppt',
			size: 200000000
		},
		null,
		callback
	);

レスポンスの例

{
  "upload_token": "Pc3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQP",
  "upload_url": "https://upload-las.app.box.com/api/2.0/files/content?upload_session_id=1234"
}