<< Click to Display Table of Contents >> Navigation: API V3 マニュアル > リファレンス > files > upload_session/start |
ファイルの分割アップロードを開始します。
multipart/form-data形式でアップロードしたいファイルの先頭とパラメータを送信してください。
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に指定します。 |
※エラーについてはこちらをご覧ください。