1. 调用结构

1.1 请求描述

腾讯云对象存储的 RESTful API 请求遵循以下结构：

参数名称	必选性	类型	描述
Version	是	String	HTTP 版本
URL	是	String	HTTP 请求地址，总长度不得超过 1024 字节
Header	是	数据集合	HTTP 请求头部
HTTP Method	是	String	HTTP 请求方法，常用 GET 或 POST
Request Body	否	json	HTTP 请求正文

1.2 URL 格式示例

https://sh.file.myqcloud.com/files/v2/
   
    /
    
     [/
     
      /
      
       ]

Region：所在地域，枚举值为 sh、gz、sgp 等。

appid：腾云云对象存储控制台创建项目后获取的项目编号。

bucket_name：项目下的存储桶名称。

<dir_name> 和 <file_name>：对应的文件路径，可以是任意有效字符串。

1.3 Header 结构

参数名称	必选性	类型	描述
Host	是	String	文件云服务器域名，形式为 `.file.myqcloud.com`，如 sh.file.myqcloud.com
Authorization	是	String	鉴权签名，有效签名字符串
Content-Type	是	String	根据要求填写 application/json 或 multipart/form-data
Content-Length	是	Int	请求长度，单位：字节

1.4 示例请求

POST /files/v2/10000202/buckettest/foldertest/ HTTP/1.1Host: sh.file.myqcloud.comContent-Type: application/jsonContent-Length: 15Authorization: 1k2i3/EXIiTDirFg9DoKgWNHc4JhPTEwMDAwMjAyJms9QUtJRFBOUHVyNUIyN3FjdVJhakNFbXpLVjkzVTdrOFZjZXFXJmU9MTQ2NTg3NTU0OSZ0PTE0NjU4NzUzNjkmcj03MTI5NDYyMzQmZj0mYj1qb25ueHU1{    "op": "create"}

2. 返回结构

2.1 返回描述

所有 API 调用返回 HTTP 标准状态码、头部信息和 JSON 格式的响应数据。

2.2 返回示例

HTTP/1.1 200 OKServer: nginxDate: Tue, 14 Jun 2016 03:36:12 GMTContent-Length: 109{    "code": 0,    "message": "SUCCESS",    "data": {}}

2.3ibriation Details

code：服务端返回码

message：服务端提示内容

data：服务端返回的应答数据

上一篇：面试实战一：2019.10.17

下一篇：传输层（第四层）UDP 协议

发表评论

关于作者

喝酒易醉，品茶养心，人生如梦，品茶悟道，何以解忧？唯有杜康！

-- 愿君每日到此一游！

1. 调用结构

1.1 请求描述

1.2 URL 格式示例

1.3 Header 结构

1.4 示例请求

2. 返回结构

2.1 返回描述

2.2 返回示例

2.3ibriation Details

发表评论

最新留言

关于作者

推荐文章