メインコンテンツへスキップ
POST
/
files
/
upload_sessions
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",
  "session_expires_at": "2012-12-12T10:53:43-08:00",
  "part_size": 1024,
  "total_parts": 1000,
  "num_parts_processed": 455,
  "session_endpoints": {
    "upload_part": "https://{box-upload-server}/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD",
    "commit": "https://{box-upload-server}/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/commit",
    "abort": "https://{box-upload-server}/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD",
    "list_parts": "https://{box-upload-server}/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/parts",
    "status": "https://{box-upload-server}/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD",
    "log_event": "https://{box-upload-server}/api/2.0/files/upload_sessions/F971964745A5CD0C001BBE4E58196BFD/log"
  }
}
このリソースは、バージョン2024.0のエンドポイントで使用されています。 詳細については、 Box APIのバージョン管理を参照してください。「Box SDKのバージョニング戦略について詳しく学ぶ。」

認証

​
Authorization
string
header
必須

The access token received from the authorization server in the OAuth 2.0 flow.

ボディ

application/json
​
folder_id
string
必須

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

例:

"0"

​
file_size
integer<int64>
必須

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

例:

104857600

​
file_name
string
必須

新規ファイルの名前。

例:

"Project.mov"

レスポンス

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

ファイルをアップロードするチャンクのアップロードセッション。

​
id
string

このセッションの一意の識別子。

例:

"F971964745A5CD0C001BBE4E58196BFD"

​
type
enum<string>

値は常にupload_sessionになります。

利用可能なオプション:
upload_session
例:

"upload_session"

​
session_expires_at
string<date-time>

このセッションが期限切れになる日時。

例:

"2012-12-12T10:53:43-08:00"

​
part_size
integer<int64>

アップロードのすべての部分で使用する必要があるサイズ (バイト単位)。

最後の部分のみ、これより小さいサイズを使用できます。

例:

1024

​
total_parts
integer<int32>

ファイルのサイズとパーツのサイズで決定される、このアップロードセッションで予想されるパーツの総数。

例:

1000

​
num_parts_processed
integer<int32>

アップロードが完了し、サーバーで処理されたパーツの数。値は0から始まります。

ファイルをコミットするときにこのプロパティを調べることで、すべてのパーツが正しくアップロードされているかどうかを確認できます。

例:

455

​
session_endpoints
セッションエンドポイント · object

このセッションに使用されるエンドポイントのリスト。