「响应设计规范」标签下共 5 篇技术文章，包括《JSON、表单与图片接口的响应设计规范：先定形状，再定字段》、《JSON、表单与图片接口的响应设计规范：统一契约后，错误与二》、《JSON、表单、图片接口的响应设计规范：判定信号、错误定位与》。按发布时间倒序排列，内容持续更新。
响应设计的核心是让客户端先判断响应类型与成败，再读业务字段。错误体应统一为可判定字段并与状态码一致；成功体按 Content-Type 分流，图片接口需避免把错误当图片返回；新增字段要向后兼容。具体平台的实现细节需以官方文档为准。
三类接口应共用外层契约：用 HTTP 状态码表达结果类别，用固定错误体携带 code、message、request_id，成功载荷再按媒体类型分开。JSON 返回顶层对象并明确分页与精度；表单响应用字段级错误定位；图片成功时返回二…
三类接口应共用一套成功判定信号：HTTP 状态码加内容类型；JSON 用稳定错误码与字段级错误，表单校验失败用 422 并把错误落到字段名，图片接口成功即返回图片字节、失败才返回结构化错误体。文中给出可复用的契约清单和部分成功、限流…
三类接口不该共用一套万能返回体：JSON 端点要固定成功形态并给出字段级错误对象；表单端点要区分浏览器提交与 fetch 调用，成功跳转、失败回填并前置拦截超大载荷；图片端点要以二进制为主体，把 Content-Type、长度、缓存…
文章给出 JSON、表单、图片三类接口的响应设计约定：JSON 用统一四字段信封与稳定错误码，表单按 Accept 做内容协商并返回字段级错误，图片默认返回二进制、需要元数据时切 JSON，并统一携带 request_id 便于追踪…
共 5 篇文章，第 1 / 1 页