「API 契约设计」标签文章

JSON、表单与图片接口的响应设计规范：先定形状，再定字段

响应设计的核心是让客户端先判断响应类型与成败，再读业务字段。错误体应统一为可判定字段并与状态码一致；成功体按 Content-Type 分流，图片接口需避免把错误当图片返回；新增字段要向后兼容。具体平台的实现细节需以官方文档为准。