ファイルのアップロード
ファイルをアップロードします。
API の種類
サービス API
Request URL
https://file.drive.worksmobile.com/drive/rl/{resourceLocation}/v2/files
HTTP Method
POST (Content-Type: multipart/form-data; boundary="$boundary”; charset=UTF-8)
Content-Disposition: form-data; name="Filedata"; filename="$resourceName"以降がアップロードするファイルのデータです。
Filedata は一番最後に位置する必要があります。
Request
Request Header
ヘッダー | タイプ | 必須 | 説明 |
---|---|---|---|
X-DRIVE-API-TYPE | String | Y | ユーザーが LINE WORKS の対象ドメインに所属していることを示すヘッダー。 常に「reseller-api」 |
Path Parameters
パラメータ | タイプ | 説明 |
---|---|---|
resourceLocation | String | アップロードするファイルのロケーションコード |
Form Parameters
パラメータ | タイプ | 必須 | 説明 |
---|---|---|---|
toParentKey | String | Y | アップロードするフォルダのキー |
resourceName | String | Y | アップロードするファイル名 |
fileSize | Long | N | アップロードするファイルのサイズ |
lastModified | String | N | アップロードするファイルの修正日(例:2015-10-06T10:17:35+09:00) |
writeMode | String | N | アップロード方法 ● none: 通常(既定値) ● overwrite: 上書き |
Filedata | raw-file | Y | アップロードするファイルデータ。 一番最後に位置する必要があります。 |
Request Example
POST /drive/rl/12345/v2/files HTTP/1.1
Host: file.drive.worksmobile.com
X-DRIVE-API-TYPE: reseller-api
consumerkey: LQwDde6x8eV4ROOCOdSW
Authorization: Bearer AAAA67h9/36ItvAEea7G8ijrDeCy/22BO5IcP0/KkwZO6unIYET6xkmp3RLW
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryBryiDBVuGfiHtwoS
Content-Length: 764
------WebKitFormBoundaryBryiDBVuGfiHtwoS
Content-Disposition: form-data; name="toParentKey"
MTQ1MDMwMDJ8NjQyMDY1MzUzNDgwfER8MA
------WebKitFormBoundaryBryiDBVuGfiHtwoS
Content-Disposition: form-data; name="resourceName"
3423.txt
------WebKitFormBoundaryBryiDBVuGfiHtwoS
Content-Disposition: form-data; name="fileSize"
5
------WebKitFormBoundaryBryiDBVuGfiHtwoS
Content-Disposition: form-data; name="writeMode"
none
------WebKitFormBoundaryBryiDBVuGfiHtwoS
Content-Disposition: form-data; name="lastModified"
2020-02-07T17:50:23+09:00
------WebKitFormBoundaryBryiDBVuGfiHtwoS
Content-Disposition: form-data; name="Filedata"; filename="3423.txt"
Content-Type: application/octet-stream
12345
------WebKitFormBoundaryBryiDBVuGfiHtwoS--
CURL Example
curl -XPOST 'https://file.drive.worksmobile.com/drive/rl/24101/v2/files' \
-H 'X-DRIVE-API-TYPE: reseller-api' \
-H 'consumerkey: LQwDde6x8eV4ROOCOdSW' \
-H 'Authorization: Bearer AAAA67h9/36ItvAEea7G8ijrDeCy/22BO5IcP0/KkwZO6unIYET6xkmp3RLW' \
-H 'Content-Type: multipart/form-data' \
-F 'toParentKey=root' \
-F 'resourceName=test2.txt' \
-F 'fileSize=5508' \
-F 'FileData=@test2.txt'
HTTP/1.1 201 Created
Server: NHN/ND-Server Ver 1.0
Content-Type: application/json;charset=UTF-8
Content-Length: 116
{
"resourceKey": "MTQ1MDMwMDJ8OTU5Njc2MjM2ODA4fEZ8MA",
"shareNo": 0,
"resourceNo": 959676236808,
"versionNo": 0
}
Response
プロパティ | タイプ | 説明 |
---|---|---|
versionNo | String | 上書きの場合、バージョン番号 |
resourceKey | String | 作成されたファイルのリソースキー |
shareNo | String | 作成されたファイルの共有ナンバー |
resourceNo | String | 作成されたファイルのリソースナンバー |
Response Example
HTTP/1.1 201 Created
Server: NHN/ND-Server Ver 1.0
Content-Type: application/json;charset=UTF-8
Content-Length: 116
{
"resourceKey": "MTQ1MDMwMDJ8OTU5Njc2MjM2ODA4fEZ8MA",
"shareNo": 0,
"resourceNo": 959676236808,
"versionNo": 0
}