upload_session/start

<< Click to Display Table of Contents >>

Navigation:  API V3 マニュアル > リファレンス > files >

upload_session/start

ファイルの分割アップロードを開始します。
multipart/form-data形式でアップロードしたいファイルの先頭とパラメータを送信してください。

HTTP リクエスト

POST http://<ホスト名>/fileblog/api/v3/files/upload_session/start
Authorization: Bearer <アクセストークン>
Content-Type: multipart/form-data; boundary=---------------boundary
 
---------------boundary
Content-Disposition: form-data; name="file"; filename="sample.txt"
 
<ファイルボディ>
---------------boundary
Content-Disposition: form-data; name="parameters"
Content-Type: application/json; charset=utf-8
 
{path:"/DocRoot/sample.txt", mode:"add"}
---------------boundary

※パラメータ部のデータ名は"parameters"を指定しください。

※ファイル本体部のデータ名は"file"を指定しください。

※アクセストークンについてはこちらをご覧ください。

リクエストパラメータ

名前

説明

path

String, 必須

アップロード先のファイルのパスを指定します。パスについてはこちらをご覧ください。

mode

String

同名ファイルが存在した場合の動作を指定します。addが指定された場合に、既存ファイルがあると上書きを失敗させます。overwriteは上書きします。デフォルトはaddです。

リクエストパラメータはファイル本体と一緒にマルチパートで送信してください。フォームデータ名は"parameters"としてください。またContent-Type: application/json; charset=utf-8を忘れずに指定してください。

レスポンス

HTTP/1.1 200 OK
{
 "session_id": "61A631216461443D8810E6AE0E01CF0E"
}

リクエストが成功すると、レスポンスコードが200、レスポンスボディにJson形式で結果が返されます。

レスポンスパラメータ

名前

説明

session_id

String

アップロードセッションIDです。このIDを続く、append,finishに指定します。

エラーレスポンス

※エラーについてはこちらをご覧ください。