对象存储API文档
对象存储API文档
一、环境配置
1、API环境
如果使用爱秒云产品（云vps，云服务器）
内网地址：http://ywapi.storagesdk.com/
2、参数说明
Ø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。
以下均以示例参数，请以正确参数为准
二、获取token
1、获取token方法
http://api.storagesdk.com/restful/storageapi/storage/getToken |
2、请求方式：post
3、请求参数
请求参数名称 | 说明 | 功能选择 |
voucher accessKey secretKey resource | 用户凭证 用户云存储accessKey 用户云存储secretKey 调用来源 | 必选 必选 必选 必选 |
三、上传文件
1、上传方法
http://api.storagesdk.com/restful/storageapi/file/uploadFile |
2、请求方式：post
3、请求参数
请求参数名称 | 说明 | 功能选择 |
token resource bucketName fileName length input | 用户操作秘钥 调用来源 空间名 上传到爱秒云存储中显示的文件名文件长度 InputStream流 | 必选 必选 必选 必选 必选 必选 |
注意：
²参数需放到请求头里传入（即HttpURLConnection.setRequestProperty()）
²length为文件长度，即流的长度，可通过InputStream.available()来获取
²将InputStream流放到OutputStream流里面传入
²需要对文件完整路径用BASE64Encoder进行编码
²文件名里不能包含特殊字符，具体见创建文件夹，和重命名文件规定
其中，bucketName空间名的获取，参考《2、查看空间名》
4、返回结果
返回结果为json字符串格式。其中，code=0为成功；其他为失败，message是失败信息。
{ "code": 0, "message": "success" } |
四、获取文件链接
1、获取文件链接方法
http://api.storagesdk.com/restful/storageapi/file/getFileUrl |
2、请求方式：post
3、请求参数
请求参数名称 | 说明 | 功能选择 |
bucketName fileName token minutes leng resource | 空间名 文件完整路径 用户操作秘钥 链接有效时间 链接长短（0为短连接，1为长链接） 调用来源 | 必选 必选 必选 可选 可选 必选 |
五、删除文件
1、删除文件方法
http://api.storagesdk.com/restful/storageapi/file/deleteFile |
2、请求方式：post
3、请求参数
请求参数名称 | 说明 | 功能选择 |
bucketName fileName token resource | 空间名 文件完整路径 用户操作秘钥 调用来源 | 必选 必选 必选 必选 |
六、删除文件夹
1、 删除文件夹方法
http://api.storagesdk.com/restful/storageapi/folder/deleteFolder |
2、 请求方式：post
3、 请求参数
请求参数名称 | 说明 | 功能选择 |
bucketName folderName token resource | 空间名 文件夹名称 用户操作秘钥 调用来源 | 必选 必选 必选 必选 |
七、重命名文件夹
1、重命名文件夹方法
http://api.storagesdk.com/restful/storageapi/folder/renameFolder |
2、请求方式：post
3、请求参数
请求参数名称 | 说明 | 功能选择 |
bucketName oldFolderName newFolderName token resource | 空间名 旧文件夹 新文件夹 用户操作秘钥 调用来源 | 必选 必选 必选 必选 必选 |
八、重命名文件
1、 重命名文件方法
http://api.storagesdk.com/restful/storageapi/file/renameFile |
2、 请求方式：post
3、 请求参数
请求参数名称 | 说明 | 功能选择 |
bucketName oldFileName newFileName token resource | 空间名 旧文件名 新文件名 用户操作秘钥 调用来源 | 必选 必选 必选 必选 必须 |
九、复制文件夹
1、 复制文件夹方法
http://api.storagesdk.com/restful/storageapi/folder/copyFolder |
2、 请求方式：post
3、请求参数
请求参数名称 | 说明 | 功能选择 |
oldBucketName oldFolderName newBucketName newFolderName token resource | 源空间 旧文件夹 目标空间 新文件夹 用户操作秘钥 调用来源 | 必选 必选 必选 必选 必选 必选 |
十、复制文件
1、复制文件方法
http://api.storagesdk.com/restful/storageapi/file/copyFile |
2、请求方式：post
3、请求参数
请求参数名称 | 说明 | 功能选择 |
oldBucketName oldFileName newBucketName newFileName token resource | 源空间 源文件 目标空间 目标文件 用户操作秘钥 调用来源 | 必选 必选 必选 必选 必选 必选 |
十一、获取文件列表
1、获取文件列表方法
http://api.storagesdk.com/restful/storageapi/folder/getSubFoldersAndFiles |
2、请求方式：post
3、请求参数
请求参数名称 | 说明 | 功能选择 |
bucketName folderName isGetFile token resource | 空间名 文件夹完整路径 是否获取文件[true.是,false.否] 用户操作秘钥 调用来源 | 必选 必选 必选 必选 必选 |
十二、帮助
1、获取key值对，获取凭证和验证来源
会员中心——“爱秒云存储”——>“管理”
点击获取凭证，凭证会发送到绑定邮箱。
2、查看空间名
会员中心——“爱秒云存储”——>“管理”
“新建空间”——>可以创建空间
ØJava SDK 提取码：v6v6
ØPHP SDK 提取码：dzff
ØC# SDK 提取码：w5um
对象存储api文档 提取码：9zbk
公安备案号：