数据保险箱公共请求头部-API 文档-文档中心-腾讯云

描述

本文档将为您介绍在使用 API 时会使用到的公共请求头部（Request Header），下文提到的请求头部在其他的具体 API 文档中不再赘述。

Header 名称	是否必选	类型	描述
Authorization	是必选。	string	携带鉴权信息，用以验证请求合法性的签名信息。针对公有读的对象可不携带此头部，如通过请求参数传递鉴权信息也无需携带此头部，详情请参见请求签名文档。
Content-Length	针对 PUT 和 POST 请求，此头部是必选项。	integer	RFC 2616中定义的 HTTP 请求内容长度（字节）。
Content-Type	针对有请求体的 PUT 和 POST 请求，此头部是必选项。	string	RFC 2616中定义的 HTTP 请求内容类型（MIME）例如`application/xml`或`image/jpeg`。
Content-MD5	否。	string	RFC 1864中定义的请求体内容的16字节二进制 MD5 哈希值的 Base64 编码形式，最终的取值长度应为24个字符，请注意在编写代码时使用正确的方法和参数，例如`ZzD3iDJdrMAAb00lgLLeig==`。此头部用于完整性检查，验证请求体在传输过程中是否发生变化。针对有请求体的 PUT 和 POST 请求（除 POST Object），强烈建议携带此头部。
Date	否。	string	RFC 1123中定义的 GMT 格式当前时间，例如`Wed, 29 May 2019 04:10:12 GMT`。
Host	是。	string	请求的主机，形式为`cdcs.<Region>.myqcloud.com。`
x-cdcs-security-token	当使用临时密钥并通过 Authorization 携带鉴权信息时，此头部为必选项。	string	使用临时安全凭证时需要传入的安全令牌字段。