「ETag」标签下共 12 篇技术文章，包括《JSON、表单与图片接口的响应设计规范：统一契约后，错误与二》、《HTTP 缓存与 CDN 加速实践：先划定 API 响应的可》、《HTTP 缓存与 CDN 加速：缓存键、条件请求与失效顺序的》。按发布时间倒序排列，内容持续更新。
三类接口应共用外层契约：用 HTTP 状态码表达结果类别，用固定错误体携带 code、message、request_id，成功载荷再按媒体类型分开。JSON 返回顶层对象并明确分页与精度；表单响应用字段级错误定位；图片成功时返回二…
缺少接口契约与 CDN 配置材料时，缓存与加速应先判断响应是否可共享、缓存键是否稳定、失效是否可控；具体 TTL、命中率和 API.PLUS 的支持范围待核实。
缓存效果取决于四件事：谁能存、存多久、按什么键存、怎么失效，这些都写在响应头里；CDN 只是按声明执行。排查应从缓存键与 Vary 入手，再看 s-maxage 与失效是否生效；304 只省带宽不省源站计算。具体 CDN 产品对指令…
HTTP 缓存与 CDN 加速的关键不在开启 CDN，而在于给每类资源写清可缓存性、复用条件与失效方式。本文对照 Cache-Control 主要指令、浏览器与共享缓存的差异、按资源分层的响应头组合、常见失效场景与上线顺序，并说明 …
三类接口的响应设计要先按载荷形态分开（JSON 结构化数据、表单提交后的结构化回执、图片二进制流），再用同一套错误结构收口。关键约束是 Content-Type 准确、错误不伪装成 200、图片接口把元信息放头部而非塞进 JSON、…
CDN 加速效果主要由三件事决定：缓存键是否只包含决定响应内容的因素、新鲜度与校验策略是否匹配内容变更节奏、源站与 CDN 的回源责任是否边界清晰。缓存键过宽会降低命中率，过窄会造成错配；共享缓存与私有缓存的有效期需要分别看待；回源…
缓存与 CDN 的收益来自减少回源，但正确性取决于三件事：响应能否被共享缓存存储、缓存键是否覆盖影响内容的所有请求维度、过期后由谁校验或失效。本文按 RFC 9111 的通用语义解释 max-age 与 s-maxage 的作用范围…
三类接口应共用一套成功判定信号：HTTP 状态码加内容类型；JSON 用稳定错误码与字段级错误，表单校验失败用 422 并把错误落到字段名，图片接口成功即返回图片字节、失败才返回结构化错误体。文中给出可复用的契约清单和部分成功、限流…
CDN 上的缓存问题常出在三个边界：缓存键包含哪些部分、过期后用什么校验器回源、哪些请求头通过 Vary 参与匹配。缓存键漏掉影响响应的参数会串内容，纳入无关参数会碎片化；ETag 生成不稳定会让每次发布都全量回源；Vary: Au…
共 12 篇文章，第 1 / 2 页