公共请求头部

最近更新时间:2026-01-21 11:41:12

我的收藏

描述

此篇文档将为您介绍在使用 API 时会使用到的公共请求头部(Request Header),下文提到的头部在之后的具体 API 文档中不再赘述。

请求头部列表

Header 名称
描述
类型
是否必选
Authorization
携带鉴权信息,用以验证请求合法性的签名信息;
针对公有读的对象可不携带此头部,如通过请求参数传递鉴权信息也无需携带此头部,详情请参见 请求签名 文档
string
是,
针对公有读的对象或通过请求参数传递鉴权信息,此头部为可选项
Content-Length
RFC 2616中定义的 HTTP 请求内容长度(字节)
integer
强烈建议携带此头部
Content-Type
RFC 2616中定义的 HTTP 请求内容类型(MIME)例如application/xml 或 application/json
string
Content-MD5
RFC 1864中定义的请求体内容的16字节(128位)二进制 MD5 哈希值的 Base64 编码形式,用于完整性检查,验证请求体在传输过程中是否发生变化,最终的取值长度应为24个字符,请注意在编写代码时使用正确的方法和参数,例如 ZzD3iDJdrMAAb00lgLLeig==
string
Date
RFC 1123中定义的 GMT 格式的当前时间,例如 Wed,29 May 2019 04:10:12 GMT
string
Host
请求的域名,例如 vectors.<region>.coslake.com,<region> 为可用地域,如 ap-guangzhou。
string