接口契约安全规范

触发场景

• 新增或调整 HTTP/JSON 接口
• 前后端联调
• 列表页、分页、筛选项、状态枚举或详情页异常
• 前端开始兼容多种 response shape
• 后端某些接口没有走项目统一成功响应 helper

核心原则

• 先看真实接口输入输出，再下结论，不根据前端类型或旧记忆推测
• 能修后端契约根因时，优先统一后端；前端兼容只作为短期过渡
• 列表、详情、选项或枚举接口应遵守同一套成功响应格式
• 分页结构必须明确约定，不长期混用数组和分页对象
• 临时兼容可以保留，但必须写清退出条件和移除时机

检查清单