对象存储API文档

发布时间:2018-04-13 浏览次数:1179

快云对象存储API文档(基础版)v2.0

一、环境配置

1、API环境

外网:http://api.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

调用来源

必选

必选

必选

必选

参数示例:

{

"voucher":"dcb99d196dd2418ec1fdfa7269ee4b81",

"accessKey":"I1I7CLU4708LI8XQ0ODL",

"secretKey":"N41hrYy14gI03RpnZijfezGl/VUtZP3b77vjF6nn"

"resource":"VG3OQ81wtrNGANeuq8IdwWxGFK0xdA3X"

}

4、返回结果

返回结果为json字符串格式。其中,code=0为成功;其他为失败,message是失败信息。

{

"code": 0,

"message": "token:d23320121807eff273c6f09c6361a42a"

}

三、上传文件

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

四、请求方式:post获取文件链接

2、

3、请求参数

请求参数名称

说明

功能选择

bucketName

fileName

token

minutes

leng

resource

空间名

文件完整路径

用户操作秘钥

链接有效时间

链接长短(0为短连接,1为长链接)

调用来源

必选

必选

必选

可选

可选

必选

参数示例:

{

"resource":"VG3OQ81wtrNGANeuq8IdwWxGFK0xdA3X",

"token":"d23320121807eff273c6f09c6361a42a",

"bucketName":"demobkt",

"fileName":"1.jpg",

"minutes":"0",

"leng":"0"

}

4、返回结果

返回结果为json字符串格式。其中,code=0为成功;其他为失败,message是失败信息。

{

"code": 0,

"message": "http://demobkt.kuaiyunds.com/demobkt/1.jpg"

}

五、删除文件

1、删除文件方法

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

2、请求方式:post

3、请求参数

请求参数名称

说明

功能选择

bucketName

fileName

token

resource

空间名

文件完整路径

用户操作秘钥

调用来源

必选

必选

必选

必选

参数示例:

{

"resource":"VG3OQ81wtrNGANeuq8IdwWxGFK0xdA3X",

"token":"d23320121807eff273c6f09c6361a42a",

"bucketName":"demobkt",

"fileName":"1.jpg"

}

4、返回结果

返回结果为json字符串格式。其中,code=0为成功;其他为失败,message是失败信息。

{

"code": 0,

"message": "success"

}

六、帮助

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

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

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

2、查看空间名

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

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

ØJava SDK

ØPHP SDK

ØC# SDK

以上文章是否对您有帮助?
  • 服务热线   400-717-9999
  • 每日签到领积分