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