请求头 (HTTP Request Header)
Qiniu S3 API 服务只支持规则化的 HTTP 请求头名称,如 accept-encoding
应转换为 Accept-Encoding
,客户端使用非规则化的 HTTP 请求头名称可能导致未知错误。
常用请求头列表
名称 | 描述 | 要求 |
---|---|---|
Host | 参见 Qiniu S3 API 简介 中关于 访问域名 的说明 | Y |
Authorization | 请求认证信息 | Y |
Content-Length | 请求体长度 (bytes, RFC 2616),PUT 类请求必须指定该值。 | CY |
Content-Type | 请求体数据类型,如 image/png;如果该值为空,系统将根据对象名称返回响应类型。 | N |
Content-MD5 | Base64 编码的请求体 MD5 摘要值 (RFC 1864)。当请求头中包含该值,系统将据此校验请求体是否合法。 | N |
Date | 请求时间 (RFC 2616)。如果客户端无法指定该值,必须通过 X-Amz-Date 指定请求对应的时间。 | CY |
Expect | 请求客户端可以使用 100-continue 在发送请求体前确定当前请求是否能被正确执行,如在发送数据前验证请求头签名是否正确。 | N |
X-Amz-Content-Sha256 | AWS V4 认证签名请求中对应的请求体 HMAC-SHA256 签名信息 | N |
X-Amz-Date | 请求时间 (RFC 2616),如果请求头中同时出现 Date 和 X-Amz-Date,则 X-Amz-Date 具有更高优先级。 | CY |
- Y, 必须
- CY, 条件约束必须
- N, 非必须