JSON、表单、图片三类接口:先定“客户端怎么判定成功”,再定响应体
三类端点的差别不在 JSON 好不好看,而在客户端判定成功的信号顺序:JSON 依赖状态码与可解析体,表单类依赖状态码与 Location,图片类依赖 Content-Type 与字节完整性。规范应先写清判定顺序与失败时的可读错误,…
「缓存」标签下共 35 篇技术文章。按发布时间倒序排列,内容持续更新。
三类端点的差别不在 JSON 好不好看,而在客户端判定成功的信号顺序:JSON 依赖状态码与可解析体,表单类依赖状态码与 Location,图片类依赖 Content-Type 与字节完整性。规范应先写清判定顺序与失败时的可读错误,…
HTTP 缓存决定响应能否复用、复用多久、由谁复用,CDN 只是共享缓存的一种部署位置,因此加速的前提是把 API 响应分成可共享、仅私有、不可缓存三类。文章说明 GET 与鉴权请求在共享缓存中的默认限制,比较 max-age、s-…
三类端点的成功响应形态不同:JSON 返回可解析结构,浏览器表单返回重定向或 HTML,图片返回字节流。因此错误契约应按端点类型分别定义:JSON 与 API 表单用结构化错误体,浏览器表单返回 HTML 或重定向,图片端点出错时不…
随机图片 API 的接入难点不在发请求,而在三处:先分清返回二进制、跳转还是 JSON;再处理“每次不同”与 CDN 缓存之间的冲突,缓存键只放分类和尺寸,不放时间戳;最后处理去重、失败兜底与图片授权边界。文末给出接入前的核实清单。…
三类端点应分别围绕 JSON 结构、表单提交语义和图片字节设计响应;可以统一错误码,但不宜强推同一 JSON 外壳,并应明确字段错误、内容协商、缓存与上传边界。
Cloudflare 宣布私有源站服务 GA 后,公网流量可以在源站不暴露公网入口的前提下经过边缘的 WAF、bot 管理、缓存与 Workers。文章拆解这条链路的三个关键点:WAF 依赖真实客户端信息传递,缓存要先界定哪些响应可…
随机图片 API 的难点不在取图,而在随机入口与缓存的天生冲突,以及图片体积、失败降级和滥用防护。本文给出可落地的分层做法:随机入口不缓存、图片按内容寻址长缓存、按宽度档位与格式协商取图、服务端代理隐藏密钥并做超时与降级;同时说明 …
三类接口不该共用一套万能返回体:JSON 端点要固定成功形态并给出字段级错误对象;表单端点要区分浏览器提交与 fetch 调用,成功跳转、失败回填并前置拦截超大载荷;图片端点要以二进制为主体,把 Content-Type、长度、缓存…
随机图片 API 慢在图片本体不在接口:把返回形态选对、加一层本地与 Nginx 缓存、压掉图片体积,P95 从 1.2s 降到 200ms 以内是常规结果。
共 35 篇文章,第 3 / 4 页