「内容协商」标签文章

JSON、表单与图片接口的响应设计：错误信封统一，成功载荷分开

三类接口应共用一个外层：HTTP 状态码分层、统一的错误信封（机器码、可读信息、追踪标识、字段级明细），成功载荷则按媒体类型分开——JSON 返回可演进的对象，表单接口把校验错误映射回字段路径，图片接口返回二进制流并在头部声明类型、…

JSON、表单与图片接口的响应设计：三类端点不要共用一套错误壳

三类端点应分别围绕 JSON 结构、表单提交语义和图片字节设计响应；可以统一错误码，但不宜强推同一 JSON 外壳，并应明确字段错误、内容协商、缓存与上传边界。