COS_API调用说明

目录

1. 请求包格式说明

COS使用Rest API的请求方式。

内网访问域名:
COS API访问的域名为:cosapi.tencentyun.com;
文件访问的域名为:cos.tencentyun.com。

外网访问域名:
COS API访问的域名为:cosapi.myqcloud.com;
文件访问的域名为:cos.myqcloud.com。

可以通过以下的请求方式对COS的资源进行操作:
GET
POST
PUT
DELETE

POST/PUT/DELETE 请求包的格式为:

[请求方式] /[app_name] HTTP/1.1
Host: cosapi.myqcloud.com
Accept: */*
Content-Length: xx(实体正文的长度,以字节方式存储的十进制数字来表示)
Content-Type: application/x-www-form-urlencoded

[请求参数1]=[请求参数1的值]&[请求参数2]=[请求参数2的值]&[请求参数3]=[请求参数3的值]


GET 请求包的格式为:

[请求方式] /[app_name]?[请求参数1]=[请求参数1的值]&[请求参数2]=[请求参数2的值]&[请求参数3]=[请求参数3的值] HTTP/1.1
Host: cosapi.myqcloud.com
Accept: */*
Content-Type: application/x-www-form-urlencoded

2. 公共请求参数说明

注意:
1. 所有参数都需进行URL 编码,编码时请遵守 RFC 1738
2. 每个API请求,都必须传入下面的基本参数。

参数名称 类型 描述
accessId int 申请COS资源时,由系统自动生成,可以在COS管理端的“文件操作”页面,点击“获取accessKey”查看到。
time int 当前时间戳,即从1970年1月1日0时0分0秒开始所经过的秒数。
sign string 请求串的签名。签名算法详见签名参数sign生成说明

3. 返回包格式说明

返回包的格式为:

HTTP/1.1 200 OK
Server: nginx
Date: Tue, 26 Mar 2013 06:13:38 GMT
Content-Type: text/html; charset=utf-8
Connection: close
Cos-Header-Rid: 50E05185E72F295E4277676B267354E1
Content-Length: xx (实体正文的长度,以字节方式存储的十进制数字来表示)


{"[返回参数1]":[返回参数1的值],"[返回参数2]":[返回参数2的值],"[返回参数3]":[返回参数3的值]}

4. 公共返回参数说明

公共返回参数如下,其余返回参数由各个API自行定义。

HTTP包头公共返回参数说明:

参数名称 描述
Cos-Header-Rid 操作请求对应的唯一ID。如果出现不明问题可以凭此ID查询错误日志。


HTTP内容公共返回参数说明:

参数名称 描述
code 返回码。

0:正确返回;
其他:错误返回,具体错误码含义详见#6. 错误码说明

data 操作的详细数据。
msg 如果错误,返回错误信息。


5. API列表

COS提供的API,详见:COS_API文档说明

6. 错误码说明

详见:COS_API文档说明中的“5. COS_API错误码说明”。

以上信息是否解决您的问题?

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部