首页 >  帮助中心 > 对象存储API文档

对象存储API文档

来源:对象存储API文档 点击量(454) 发布时间:2019-04-29

对象存储API文档

一、环境配置

1、API环境

外网:http://api.storagesdk.com/

如果使用爱秒云产品(云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

调用来源

必选

必选

必选

必选

02.png三、上传文件

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为长链接)

调用来源

必选

必选

必选

可选

可选

必选

04.png

五、删除文件

1、删除文件方法


http://api.storagesdk.com/restful/storageapi/file/deleteFile

2、请求方式:post

3、请求参数

请求参数名称

说明

功能选择

bucketName

fileName

token

resource

空间名

文件完整路径

用户操作秘钥

调用来源

必选

必选

必选

必选

05.png

六、删除文件夹

1、 删除文件夹方法

http://api.storagesdk.com/restful/storageapi/folder/deleteFolder

2、 请求方式:post

3、 请求参数

请求参数名称

说明

功能选择

bucketName

folderName

token

resource

空间名

文件夹名称

用户操作秘钥

调用来源

必选

必选

必选

必选

06.png

七、重命名文件夹

1、重命名文件夹方法

http://api.storagesdk.com/restful/storageapi/folder/renameFolder

2、请求方式:post

3、请求参数

请求参数名称

说明

功能选择

bucketName

oldFolderName

newFolderName

token

resource

空间名

旧文件夹

新文件夹

用户操作秘钥

调用来源

必选

必选

必选

必选

必选

07.png

八、重命名文件

1、 重命名文件方法

http://api.storagesdk.com/restful/storageapi/file/renameFile

2、 请求方式:post

3、 请求参数

请求参数名称

说明

功能选择

bucketName

oldFileName

newFileName

token

resource

空间名

旧文件名

新文件名

用户操作秘钥

调用来源

必选

必选

必选

必选

必须

08.png九、复制文件夹

1、 复制文件夹方法

http://api.storagesdk.com/restful/storageapi/folder/copyFolder

2、 请求方式:post

3、请求参数

请求参数名称

说明

功能选择

oldBucketName

oldFolderName

newBucketName

newFolderName

token

resource

源空间

旧文件夹

目标空间

新文件夹

用户操作秘钥

调用来源

必选

必选

必选

必选

必选

必选

09.png


十、复制文件

1、复制文件方法

http://api.storagesdk.com/restful/storageapi/file/copyFile

2、请求方式:post

3、请求参数

请求参数名称

说明

功能选择

oldBucketName

oldFileName

newBucketName

newFileName

token

resource

源空间

源文件

目标空间

目标文件

用户操作秘钥

调用来源

必选

必选

必选

必选

必选

必选

 10.png

十一、获取文件列表

1、获取文件列表方法

http://api.storagesdk.com/restful/storageapi/folder/getSubFoldersAndFiles

2、请求方式:post

3、请求参数

请求参数名称

说明

功能选择

bucketName

folderName

isGetFile

token

resource

空间名

文件夹完整路径

是否获取文件[true.,false.]

用户操作秘钥

调用来源

必选

必选

必选

必选

必选

 11.png

十二、帮助

1、获取key值对,获取凭证和验证来源

会员中心——“爱秒云存储”——>“管理”

点击获取凭证,凭证会发送到绑定邮箱。

2、查看空间名

会员中心——“爱秒云存储”——>“管理”

“新建空间”——>可以创建空间

ØJava SDK 提取码:v6v6

ØPHP SDK 提取码:dzff

ØC# SDK  提取码:w5um

对象存储api文档 提取码:9zbk


  • 服务热线   170-8003-9991