HTTP请求头(HTTP Header)
按名称排序
HTTP Request Header
Accept
支持的特性
|
Accept-Charset
支持的特性
|
Accept-Encoding
支持的特性
| |
---|---|---|---|
Accept-Language
支持的特性
|
Accept-Ranges
断点续传
|
Authorization
身份认证
| |
Cache-Control
缓存控制
|
Connection
长连接
|
Cookie
会话跟踪
| |
RFC
:
rfc7234
定义
:
指定请求和响应遵循的缓存策略
示例: Cache-Control: no-cache
可选值:
max-age=<seconds>
:
设置缓存最大有效期(超过则失效) -- 相对于请求时间
max-stale[=<seconds>]
:
表示客户端愿意接收一个已经过期的资源(响应不能超过的过期时间)
min-fresh=<seconds>
:
客户端希望在指定的时间内获取最新的响应
no-cache
:
不缓存过期资源(在使用缓存副本之前,强制将缓存(etag)提交给原始服务器进行验证)
no-store
:
不缓存请求/响应的任何内容
no-transform
:
禁止对资源进行转换或转变
only-if-cached
:
客户端只接收已缓存的响应,并且不要向原始服务器检查是否有更新的拷贝
| RFC
:
rfc7230
定义
:
连接类型(HTTP 1.1默认进行持久连接)
示例: Connection: close
可选值:
keep-alive
:
使用长连接
upgrade
:
协议升级
close
:
关闭长连接
| ||
Content-Length
请求上下文信息
|
Content-Type
请求上下文信息
|
Date
请求上下文信息
| |
Origin
请求上下文信息
|
Expect
请求上下文信息
|
From
请求上下文信息
| |
RFC
:
rfc7231
定义
:
服务器只有在满足指定期望条件下才能妥善地处理请求
示例: Expect: 100-continue
可选值:
100-continue
:
通知服务器->客户端将要发送一个可能很大的消息体,期望收到状态码为100 (Continue) 的临时回复,如果服务器不满足条件则返回417(Expectation Failed)状态码
| |||
Host
请求上下文信息
|
If-Match
缓存控制
|
If-Modified-Since
缓存控制
| |
RFC
:
rfc7232
定义
:
只有满足条件时才会返回资源或允许上传资源(对应于Etag响应,Etag值)
示例: If-Match: “737060cd8c284d8af7ad3082f209582d”
| RFC
:
rfc7232
定义
:
如果请求的资源在指定时间之后被修改才返回资源,未被修改则返回304代码(对应于Last-Modified响应)
示例: If-Modified-Since: Sat, 29 Oct 2010 19:43:31 GMT
| ||
If-None-Match
缓存控制
|
If-Range
断点续传
|
If-Unmodified-Since
缓存控制
| |
RFC
:
rfc7232
定义
:
只有当服务器上不存在匹配的Etag资源时才返回资源(对应于Etag响应,Etag值)
示例: If-None-Match: “737060cd8c284d8af7ad3082f209582d”
| RFC
:
rfc7233
定义
:
如果实体未改变,服务器发送客户端丢失的部分,否则发送整个实体。参数也为Etag
示例: If-Range: “737060cd8c284d8af7ad3082f209582d”
| RFC
:
rfc7232
定义
:
指定的是缓存最后一次修改时间(对应于Last-Modified响应)
示例: If-Unmodified-Since: Sat, 29 Oct 2010 19:43:31 GMT
| |
Max-Forwards
代理
|
Pragma
缓存控制
|
Proxy-Authorization
代理
| |
RFC
:
rfc7234
定义
:
用于向后兼容HTTP/1.0(常用于兼容HTTP/1.1的Cache-Control)
示例: Pragma: no-cache
可选值:
no-cache
:
在使用缓存前强制提交到源服务器进行验证(不使用过期缓存)
| |||
Range
断点续传
|
Referer
请求上下文信息
|
TE
请求上下文信息
| |
Upgrade
请求上下文信息
|
User-Agent
请求上下文信息
|
Via
请求上下文信息
| |
RFC
:
rfc7230
定义
:
协议升级(RFC7230 )
示例: Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11
可选值:
h2c
:
使用HTTP/2协议
websocket
:
使用websocket协议
| RFC
:
rfc7230
定义
:
由代理服务器(正向、反向代理)添加,用于追踪消息转发情况,防止循环请求,以及识别在请求或响应传递链中消息发送者对于协议的支持能力
示例: [
"Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1)",
"Via: HTTP/1.1 GWA"
]
| ||
Access-Control-Request-Headers
跨域请求
|
Access-Control-Request-Method
跨域请求
| ||
RFC
:
cors
定义
:
预检请求,让服务器知道哪些 HTTP 头的实际请求时将被使用
示例: Access-Control-Request-Headers: X-PINGOTHER, Content-Type
|
HTTP Responses Header
Accept-Ranges
断点续传
|
Age
缓存控制
|
Allow
支持的特性
|
---|---|---|
Cache-Control
缓存控制
|
Content-Encoding
请求上下文信息
|
Content-Language
请求上下文信息
|
RFC
:
rfc7234
定义
:
指定请求和响应遵循的缓存策略
示例: Cache-Control: no-cache
可选值:
max-age=<seconds>
:
设置缓存最大有效期(超过则失效) -- 相对于请求时间
max-stale[=<seconds>]
:
表示客户端愿意接收一个已经过期的资源(响应不能超过的过期时间)
min-fresh=<seconds>
:
客户端希望在指定的时间内获取最新的响应
no-cache
:
不缓存过期资源(在使用缓存副本之前,强制将缓存(etag)提交给原始服务器进行验证)
no-store
:
不缓存请求/响应的任何内容
no-transform
:
禁止对资源进行转换或转变
only-if-cached
:
客户端只接收已缓存的响应,并且不要向原始服务器检查是否有更新的拷贝
| RFC
:
rfc7231
定义
:
指定响应内容编码(压缩)的格式
示例: Content-Encoding: gzip
可选值:
gzip
:
一种使用 Lempel-Ziv 编码( LZ77 )和32位 CRC 的格式
x-gzip
:
同gzip,为了兼容的目的
compress
:
使用 Lempel-Ziv-Welch( LZW )算法的格式
deflate
:
使用 deflate 压缩算法(在 RFC 1951中定义)使用 zlib 结构(在 RFC 1950中定义)
br
:
使用 Brotli 算法的格式
identity
:
指示身份功能(即不压缩,也不修改)
| |
Content-Disposition
请求上下文信息
|
Content-Length
请求上下文信息
|
Content-Location
请求上下文信息
|
RFC
:
rfc6266
定义
:
指定响应的展示形式(内联或附件)
示例: Content-Disposition: attachment; filename="filename.jpg"
可选值:
inline
:
表示响应中的消息体会以页面的一部分或整个页面形式展示
attachment / filename
:
表示消息体应该被下载到本地
form-data / name / filename
:
表单数据(请求时)
| ||
Content-MD5
请求上下文信息
|
Content-Range
断点续传
|
Content-Type
请求上下文信息
|
定义
:
返回资源的MD5校验值
示例: Content-MD5: Q2hlY2sgSW50ZWdyaXR5IQ==
| ||
Date
请求上下文信息
|
ETag
缓存控制
|
Expires
缓存控制
|
Last-Modified
缓存控制
|
Location
请求上下文信息
|
Pragma
缓存控制
|
RFC
:
rfc7234
定义
:
用于向后兼容 HTTP/1.0(常用于兼容 HTTP/1.1 的Cache-Control)
示例: Pragma: no-cache
可选值:
no-cache
:
在使用缓存前强制提交到源服务器进行验证(不使用过期缓存)
| ||
Proxy-Authenticate
代理
|
refresh
非标准
|
Retry-After
请求上下文信息
|
定义
:
应用于重定向或一个新的资源被创造,在5秒之后重定向(由网景提出,被大部分浏览器支持)
示例: Refresh: 5; url=http://www.kjson.com
| ||
Server
请求上下文信息
|
Set-Cookie
会话跟踪
|
Trailer
断点续传
|
RFC
:
rfc7231
定义
:
指定处理请求的软件(服务器名称)
示例: Server: Apache/1.3.27 (Unix) (Red-Hat/Linux)
可选值:
Apache
:
Apache服务器
Nginx
:
Nginx服务器
| ||
Transfer-Encoding
请求上下文信息
|
Vary
请求上下文信息
|
Via
请求上下文信息
|
RFC
:
rfc7230
定义
:
指定将entity安全传送给用户采用的编码形式
示例: Transfer-Encoding:chunked
可选值:
chunked
:
分块传输
compress
:
采用LZW(Lempel-Ziv-Welch)压缩算法
deflate
:
deflate压缩算法
gzip
:
采用LZ77(Lempel-Ziv coding)压缩算法
identity
:
指自身(未经压缩和修改)
| RFC
:
rfc7230
定义
:
由代理服务器(正向、反向代理)添加,用于追踪消息转发情况,防止循环请求,以及识别在请求或响应传递链中消息发送者对于协议的支持能力
示例: Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1)
| |
Warning
请求上下文信息
|
Access-Control-Allow-Credentials
跨域请求
|
Access-Control-Allow-Headers
跨域请求
|
RFC
:
cors
定义
:
告知客户端请求时是否需要凭证
| RFC
:
cors
定义
:
告知客户端实际请求时允许携带的请求头部字段
示例: Access-Control-Allow-Headers: Accept,Accept-Language,Content-Language,Content-Type
| |
Access-Control-Allow-Methods
跨域请求
|
Access-Control-Allow-Origin
跨域请求
|
Access-Control-Expose-Headers
跨域请求
|
RFC
:
cors
定义
:
告知客户端实际请求时允许发起的请求方法
| RFC
:
cors
定义
:
告知客户端允许访问该资源的外域URL(不符合则客户端丢弃该请求)
| RFC
:
cors
定义
:
指定允许API读取的响应头字段(XMLHttpRequest.getResponseHeader())
|
Access-Control-Max-Age
跨域请求
|
Content-Range
断点续传
|
WWW-Authenticate
身份认证
|
RFC
:
cors
定义
:
指定预检请求(OPTION)的有效期(单位: 秒) -- 有效期内同一请求将不再发起预检请求
| RFC
:
rfc7235
定义
:
指定身份验证的方式(通常和401响应码一起发送)
示例: WWW-Authenticate: Basic realm="Access to the staging site"
|
推广