對(duì)象存儲(chǔ)API文檔
發(fā)布時(shí)間：2019-02-13 瀏覽次數(shù)：10908
快云對(duì)象存儲(chǔ)API文檔（基礎(chǔ)版）v3.0
一、環(huán)境配置
1、API環(huán)境
外網(wǎng)：http://api.storagesdk.com/
如果使用快云產(chǎn)品（云vps，云服務(wù)器）
內(nèi)網(wǎng)地址：http://ywapi.storagesdk.com/
2、參數(shù)說明
?accesskey ：用戶秘鑰對(duì)，云存儲(chǔ)accessKey，開通快云存儲(chǔ)時(shí)的Access_Key，可在會(huì)員中心獲取
?secretkey ：用戶秘鑰對(duì)，云存儲(chǔ)secretKey，開通快云存儲(chǔ)時(shí)的Secret_Key，可在會(huì)員中心獲取
?voucher ：用戶憑證，可在會(huì)員中心點(diǎn)擊，以郵件形式獲取
?token: 用戶操作秘鑰，是用戶調(diào)用api接口時(shí)必須用到的的秘鑰；可以通過API獲取
?resource ：API調(diào)用來源，可在會(huì)員中心點(diǎn)擊獲取
注：
1．a(chǎn)ccessKey、secretKey以及voucher、resource 獲取方法，參看幫助《1、獲取key值對(duì)，獲取憑證，獲取調(diào)用來源》；
2．a(chǎn)ccessKey、secretKey以及voucher對(duì)每個(gè)用戶來說都是唯一的，用來獲取操作秘鑰token；
3．每次token獲取后有效時(shí)間為24個(gè)小時(shí)，每個(gè)用戶一天最多可獲取10000次token。
以下均以示例參數(shù)，請(qǐng)以正確參數(shù)為準(zhǔn)
二、獲取token
1、獲取token方法
http://api.storagesdk.com/restful/storageapi/storage/getToken |
2、請(qǐng)求方式：post
3、請(qǐng)求參數(shù)
請(qǐng)求參數(shù)名稱 | 說明 | 功能選擇 |
voucher accessKey secretKey resource | 用戶憑證 用戶云存儲(chǔ)accessKey 用戶云存儲(chǔ)secretKey 調(diào)用來源 | 必選 必選 必選 必選 |
三、上傳文件
1、上傳方法
http://api.storagesdk.com/restful/storageapi/file/uploadFile |
2、請(qǐng)求方式：post
3、請(qǐng)求參數(shù)
請(qǐng)求參數(shù)名稱 | 說明 | 功能選擇 |
token resource bucketName fileName length input | 用戶操作秘鑰 調(diào)用來源 空間名 上傳到快云存儲(chǔ)中顯示的文件名文件長(zhǎng)度 InputStream流 | 必選 必選 必選 必選 必選 必選 |
注意：
2參數(shù)需放到請(qǐng)求頭里傳入（即HttpURLConnection.setRequestProperty()）
2length為文件長(zhǎng)度，即流的長(zhǎng)度，可通過InputStream.available()來獲取
2將InputStream流放到OutputStream流里面?zhèn)魅?/span>
2需要對(duì)文件完整路徑用BASE64Encoder進(jìn)行編碼
2文件名里不能包含特殊字符，具體見創(chuàng)建文件夾，和重命名文件規(guī)定
其中，bucketName空間名的獲取，參考《2、查看空間名》
4、返回結(jié)果
返回結(jié)果為json字符串格式。其中，code=0為成功；其他為失敗，message是失敗信息。
{ "code": 0, "message": "success" } |
四、獲取文件鏈接
1、獲取文件鏈接方法
http://api.storagesdk.com/restful/storageapi/file/getFileUrl |
2、請(qǐng)求方式：post
3、請(qǐng)求參數(shù)
請(qǐng)求參數(shù)名稱 | 說明 | 功能選擇 |
bucketName fileName token minutes leng resource | 空間名 文件完整路徑 用戶操作秘鑰 鏈接有效時(shí)間 鏈接長(zhǎng)短（0為短連接，1為長(zhǎng)鏈接） 調(diào)用來源 | 必選 必選 必選 可選 可選 必選 |
五、刪除文件
1、刪除文件方法
http://api.storagesdk.com/restful/storageapi/file/deleteFile |
2、請(qǐng)求方式：post
3、請(qǐng)求參數(shù)
請(qǐng)求參數(shù)名稱 | 說明 | 功能選擇 |
bucketName fileName token resource | 空間名 文件完整路徑 用戶操作秘鑰 調(diào)用來源 | 必選 必選 必選 必選 |
六、刪除文件夾
1、 刪除文件夾方法
http://api.storagesdk.com/restful/storageapi/folder/deleteFolder |
2、 請(qǐng)求方式：post
3、 請(qǐng)求參數(shù)
請(qǐng)求參數(shù)名稱 | 說明 | 功能選擇 |
bucketName folderName token resource | 空間名 文件夾名稱 用戶操作秘鑰 調(diào)用來源 | 必選 必選 必選 必選 |
七、重命名文件夾
1、重命名文件夾方法
http://api.storagesdk.com/restful/storageapi/folder/renameFolder |
2、請(qǐng)求方式：post
3、請(qǐng)求參數(shù)
請(qǐng)求參數(shù)名稱 | 說明 | 功能選擇 |
bucketName oldFolderName newFolderName token resource | 空間名 舊文件夾 新文件夾 用戶操作秘鑰 調(diào)用來源 | 必選 必選 必選 必選 必選 |
八、重命名文件
1、 重命名文件方法
http://api.storagesdk.com/restful/storageapi/file/renameFile |
2、 請(qǐng)求方式：post
3、 請(qǐng)求參數(shù)
請(qǐng)求參數(shù)名稱 | 說明 | 功能選擇 |
bucketName oldFileName newFileName token resource | 空間名 舊文件名 新文件名 用戶操作秘鑰 調(diào)用來源 | 必選 必選 必選 必選 必須 |
九、復(fù)制文件夾
1、 復(fù)制文件夾方法
http://api.storagesdk.com/restful/storageapi/folder/copyFolder |
2、 請(qǐng)求方式：post
3、請(qǐng)求參數(shù)
請(qǐng)求參數(shù)名稱 | 說明 | 功能選擇 |
oldBucketName oldFolderName newBucketName newFolderName token resource | 源空間 舊文件夾 目標(biāo)空間 新文件夾 用戶操作秘鑰 調(diào)用來源 | 必選 必選 必選 必選 必選 必選 |
十、復(fù)制文件
1、復(fù)制文件方法
http://api.storagesdk.com/restful/storageapi/file/copyFile |
2、請(qǐng)求方式：post
3、請(qǐng)求參數(shù)
請(qǐng)求參數(shù)名稱 | 說明 | 功能選擇 |
oldBucketName oldFileName newBucketName newFileName token resource | 源空間 源文件 目標(biāo)空間 目標(biāo)文件 用戶操作秘鑰 調(diào)用來源 | 必選 必選 必選 必選 必選 必選 |
十一、獲取文件列表
1、獲取文件列表方法
http://api.storagesdk.com/restful/storageapi/folder/getSubFoldersAndFiles |
2、請(qǐng)求方式：post
3、請(qǐng)求參數(shù)
請(qǐng)求參數(shù)名稱 | 說明 | 功能選擇 |
bucketName folderName isGetFile token resource | 空間名 文件夾完整路徑 是否獲取文件[true.是,false.否] 用戶操作秘鑰 調(diào)用來源 | 必選 必選 必選 必選 必選 |
十二、幫助
1、獲取key值對(duì)，獲取憑證和驗(yàn)證來源
會(huì)員中心——“快云存儲(chǔ)”——>“管理”
點(diǎn)擊獲取憑證，憑證會(huì)發(fā)送到綁定郵箱。
2、查看空間名
會(huì)員中心——“快云存儲(chǔ)”——>“管理”
“新建空間”——>可以創(chuàng)建空間
企業(yè)微信