公共请求头部

最近更新时间:2021-11-24 10:44:12

描述

本文档将为您介绍在使用 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/xmlimage/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 使用临时安全凭证时需要传入的安全令牌字段。