JSON、表单、图片三类接口:先定“客户端怎么判定成功”,再定响应体
三类端点的差别不在 JSON 好不好看,而在客户端判定成功的信号顺序:JSON 依赖状态码与可解析体,表单类依赖状态码与 Location,图片类依赖 Content-Type 与字节完整性。规范应先写清判定顺序与失败时的可读错误,…
「图片接口」标签下共 16 篇技术文章。按发布时间倒序排列,内容持续更新。
三类端点的差别不在 JSON 好不好看,而在客户端判定成功的信号顺序:JSON 依赖状态码与可解析体,表单类依赖状态码与 Location,图片类依赖 Content-Type 与字节完整性。规范应先写清判定顺序与失败时的可读错误,…
三类端点的成功响应形态不同:JSON 返回可解析结构,浏览器表单返回重定向或 HTML,图片返回字节流。因此错误契约应按端点类型分别定义:JSON 与 API 表单用结构化错误体,浏览器表单返回 HTML 或重定向,图片端点出错时不…
随机图片 API 的接入难点不在发请求,而在三处:先分清返回二进制、跳转还是 JSON;再处理“每次不同”与 CDN 缓存之间的冲突,缓存键只放分类和尺寸,不放时间戳;最后处理去重、失败兜底与图片授权边界。文末给出接入前的核实清单。…
三类端点应分别围绕 JSON 结构、表单提交语义和图片字节设计响应;可以统一错误码,但不宜强推同一 JSON 外壳,并应明确字段错误、内容协商、缓存与上传边界。
三类接口不该共用一套万能返回体:JSON 端点要固定成功形态并给出字段级错误对象;表单端点要区分浏览器提交与 fetch 调用,成功跳转、失败回填并前置拦截超大载荷;图片端点要以二进制为主体,把 Content-Type、长度、缓存…
响应契约设计的核心是让 Content-Type 与 HTTP 状态码承载语义:JSON 接口保持字段类型稳定并回传 request_id,表单写入用 303 或 422 讲清结果,图片接口按 Accept 决定成功与失败皆返回什么…
文章给出 JSON、表单、图片三类接口的响应设计约定:JSON 用统一四字段信封与稳定错误码,表单按 Accept 做内容协商并返回字段级错误,图片默认返回二进制、需要元数据时切 JSON,并统一携带 request_id 便于追踪…
共 16 篇文章,第 2 / 2 页