JSON、表单与图片接口的响应契约:状态码、Content-Type 与错误体怎么分工
三类接口不必共用同一个响应体,但应共用同一套判断顺序:先由状态码判定成功或失败,再由 Content-Type 决定解析方式,最后才读取响应体字段。文章给出的具体建议包括:JSON 成功体要保持全局一致;错误体至少包含稳定的机器码、…
「HTTP 状态码」标签下共 10 篇技术文章,包括《JSON、表单与图片接口的响应契约:状态码、Content-》、《GET 与 POST 请求示例怎么调试:参数位置、副作用与重》、《JSON / 表单 / 图片接口的响应设计:让客户端靠 Co》。按发布时间倒序排列,内容持续更新。
三类接口不必共用同一个响应体,但应共用同一套判断顺序:先由状态码判定成功或失败,再由 Content-Type 决定解析方式,最后才读取响应体字段。文章给出的具体建议包括:JSON 成功体要保持全局一致;错误体至少包含稳定的机器码、…
调试 GET 与 POST 的差别不在写法,而在三点:参数放在哪、请求有无副作用、失败后能否重发。先确认服务端读取参数的位置与 Content-Type,再用一条可复现的命令固定请求;读响应先看状态码、Content-Type 与响…
三类接口的响应形态应由 Content-Type 加状态码共同决定:JSON 接口返回可机读的错误码信封,表单接口面向浏览器给出重定向或带错误的页面,图片接口直接返回二进制并用响应头携带元数据;三者共用请求 ID、正确状态码和 no…
三类接口不能用一套响应模板覆盖:JSON 接口适合统一信封与稳定错误码;表单接口要先区分浏览器原生提交和脚本提交,前者用 303 跳转、后者用 JSON;图片等二进制接口的正文就是负载,错误只能靠状态码与 Content-Type …
JSON、表单和图片接口可以共用一套错误信封,但成功响应应按媒体类型分别定义;用状态码、Content-Type 和缓存头区分,避免把错误包装成 200 或伪装成图片。表单需区分浏览器与 AJAX,图片错误不得污染缓存。
三类接口可共享同一套状态码与错误语义,再按载荷分别约束 Content-Type、正文形态和失败回退;成功与失败不能用同一形状表达,图片接口尤其不能在出错时返回图片字节。API.PLUS 的具体字段与错误码需以其官方文档为准。
调试 GET / POST 示例的关键,是先让方法、URL、头部与正文四者自洽,再按“有无 HTTP 响应—状态码—原始请求”的顺序定位问题。文中示例使用 example.com 占位域名,未在本次环境执行;API.PLUS 的具体…
调试 GET/POST 请求的关键,是把“请求是否按预期发出”和“服务端是否正确处理”分成两段分别验证。本文给出通用方法:按构造、传输、语义、解析四类拆分失败;GET 用 -G 与 --data-urlencode 避免手工拼查询串…
三类端点的成功响应形态不同:JSON 返回可解析结构,浏览器表单返回重定向或 HTML,图片返回字节流。因此错误契约应按端点类型分别定义:JSON 与 API 表单用结构化错误体,浏览器表单返回 HTML 或重定向,图片端点出错时不…
共 10 篇文章,第 1 / 2 页