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

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

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

リクエスト

Bearer [ACCESS_TOKEN]
application/json

リクエスト本文

string本文内必須
Project.mov

新規ファイルの名前

integer / int64本文内必須
104857600

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

string本文内必須
0

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

レスポンス

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

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

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

何らかの理由で操作が許可されていない場合にエラーを返します。

  • storage_limit_exceeded: アカウントのストレージサイズの上限に達しました

親フォルダが見つからないか、認証済みユーザーが親フォルダにアクセスできない場合はエラーを返します。

  • invalid_parameter: folder_id値は、ユーザーがアクセスできないフォルダまたは存在しないフォルダを表します。

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

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

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

リクエストの例

cURL
curl -i -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": "Contract.pdf"
     }'

レスポンスの例

{
  "id": "F971964745A5CD0C001BBE4E58196BFD",
  "type": "upload_session",
  "num_parts_processed": 455,
  "part_size": 1024,
  "session_endpoints": {
    "abort": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD",
    "commit": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/commit",
    "list_parts": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/parts",
    "log_event": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/log",
    "status": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD",
    "upload_part": "https://upload.box.com/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD"
  },
  "session_expires_at": "2012-12-12T10:53:43-08:00",
  "total_parts": 1000
}