藍(lán)眼云盤編程接口

/api/alien/fetch/upload/token

功能：一個藍(lán)眼云盤受信任的用戶請求一個UploadToken盛垦，用于給另一個用戶向藍(lán)眼云盤上傳文件纪蜒。

一般的使用場景是應(yīng)用服務(wù)器向藍(lán)眼云盤請求UploadToken蹭秋，然后將此UploadToken交由瀏覽器去向藍(lán)眼云盤上傳文件。

參數(shù)	類型	描述
email	`string`	【必填】郵箱堤撵，用于確定請求者身份
password	`string`	【必填】密碼仁讨，用于確定請求者身份
filename	`string`	【必填】即將上傳的文件名，不能包含以下特殊符號：`< > \| * ? / \`
expire	`int`	【選填】UploadToken過期時間实昨，單位：s洞豁。默認(rèn) 86400s 即24h
privacy	`bool`	【必填】文件的共有性。`true`表示文件私有荒给，下載時必須要DownloadToken. `false`表示文件公有丈挟，任何人可以通過下載鏈接直接下載
size	`int`	【必填】文件的大小。單位：byte
dir	`string`	【必填】文件存放的路徑锐墙。不能為空礁哄，必須以`/`開頭，不能出現(xiàn)連續(xù)的`//`,不能包含以下特殊符號：`< > \| * ? \`溪北。舉例：`/app/blog/20180101121212001`

/api/alien/upload

功能：瀏覽器拿著UploadToken通過FormData向藍(lán)眼云盤上傳文件桐绒。

一般的使用場景是應(yīng)用服務(wù)器向藍(lán)眼云盤請求UploadToken，然后將此UploadToken交由瀏覽器去向藍(lán)眼云盤上傳文件之拨。由于在請求UploadToken的時候已經(jīng)傳入了文件元信息茉继，因此這里的文件信息必須要和/api/alien/fetch/upload/token傳入的參數(shù)信息一致。

參數(shù)	類型	描述
uploadTokenUuid	`string`	【必填】uploadToken標(biāo)識蚀乔，`/api/alien/fetch/upload/token`請求返回對象中的`uuid`
file	`file`	【必填】文件烁竭，在瀏覽器中是通過`<input type="file" name="file"/>`來選擇的

/api/alien/confirm

功能：應(yīng)用服務(wù)器向藍(lán)眼云盤確認(rèn)某個文件是否確實已經(jīng)上傳好了。

參數(shù)	類型	描述
email	`string`	【必填】郵箱吉挣，用于確定請求者身份
password	`string`	【必填】密碼派撕，用于確定請求者身份
matterUuid	`string`	【必填】瀏覽器上傳完畢后，藍(lán)眼云盤返回給瀏覽器的`uuid`

/api/alien/fetch/download/token

功能：一個藍(lán)眼云盤受信任的用戶請求一個DownloadToken睬魂，用于給另一個用戶下載藍(lán)眼云盤上的私有文件终吼。

一般的使用場景是應(yīng)用服務(wù)器向藍(lán)眼云盤請求DownloadToken，然后將此DownloadToken交由瀏覽器去向藍(lán)眼云盤下載文件氯哮。

參數(shù)	類型	描述
email	`string`	【必填】郵箱际跪，用于確定請求者身份
password	`string`	【必填】密碼，用于確定請求者身份
matterUuid	`string`	【必填】文件uuid喉钢，要想下載的文件`uuid`
expire	`int`	【選填】UploadToken過期時間姆打，單位：s。默認(rèn) 86400s 即24h

/api/alien/fetch/download/token

功能：一個藍(lán)眼云盤受信任的用戶請求一個DownloadToken肠虽，用于給另一個用戶下載藍(lán)眼云盤上的私有文件幔戏。

一般的使用場景是應(yīng)用服務(wù)器向藍(lán)眼云盤請求DownloadToken，然后將此DownloadToken交由瀏覽器去向藍(lán)眼云盤下載文件税课。

參數(shù)	類型	描述
email	`string`	【必填】郵箱评抚，用于確定請求者身份
password	`string`	【必填】密碼豹缀，用于確定請求者身份
matterUuid	`string`	【必填】文件uuid，要想下載的文件`uuid`
expire	`int`	【選填】UploadToken過期時間慨代，單位：s邢笙。默認(rèn) 86400s 即24h

/api/alien/download/{uuid}/{filename}

功能：在瀏覽器中下載文件

這個接口既可以下載公有文件，又可以下載私有文件侍匙。同時對于圖片文件還可以做裁剪縮放等操作氮惯。

參數(shù)	類型	描述
uuid	`string`	【必填】文件的uuid，該參數(shù)放在url的路徑中
filename	`string`	【必填】文件的名稱想暗，該參數(shù)放在url的路徑中
downloadTokenUuid	`string`	【選填】download的uuid妇汗，如果是私有文件該參數(shù)必須，公有文件無需填寫说莫。

該接口同時還可以對圖片進(jìn)行縮放預(yù)處理

圖片縮放支持的格式有：".jpg", ".jpeg", ".png", ".tif", ".tiff", ".bmp", ".gif"

額外參數(shù)

參數(shù)	類型	描述	取值范圍
imageProcess	`string`	指定圖片處理的方式杨箭，對于圖片縮放固定為`resize`	固定為`resize`
imageResizeM	`string`	指定圖片縮放的策略，有三種策略储狭，`fit` 表示固定一邊互婿，另一邊按比例縮放；`fill`表示先將圖片延伸出指定W與H的矩形框外辽狈，然后進(jìn)行居中裁剪慈参；`fixed`表示直接按照指定的W和H縮放圖片，這種方式可能導(dǎo)致圖片變形	[`fit`,`fill`,`fixed`] 不填默認(rèn)`fit`
imageResizeW	`int`	指定的寬度刮萌，對于`fit`可以不指定	1 ~ 4096
imageResizeH	`int`	指定的高度驮配，對于`fit`可以不指定	1 ~ 4096