3.36配额与 ETag 缓存

为当前请求指定配额键，用于关联在 HttpClientOptions 中配置的配额限制规则。

设置请求接口配额键#

为当前请求指定配额键，用于关联在 HttpClientOptions 中配置的配额限制规则。

cs
HttpRequestBuilder.Post("https://furion.net/")    .SetQuotaKey("wechat/accesstoken");

启用 ETag 响应缓存#

ETag（实体标签）是 HTTP 协议中用于标识资源版本的一种机制。服务器在响应头中返回资源的 ETag 值（例如 "abc123"），客户端在后续请求中可通过 If-None-Match 头携带该值。若资源未发生变化，服务器返回 304 Not Modified，无需重新传输内容；否则返回新内容及新的 ETag。

启用 ETag 缓存后，框架会自动处理这一过程：首次请求缓存响应及 ETag，后续请求自动附加 If-None-Match；收到 304 状态码时直接复用缓存内容，减少数据传输并提升请求效率。在弱网环境或移动端流量计费场景下，这一机制能显著降低带宽消耗，同时加快响应速度。

cs
HttpRequestBuilder.Get("https://furion.net/")    .UseETag();HttpRequestBuilder.Get("https://furion.net/")    .UseETag(false); // 禁用该功能（默认值）