GuangXiN

经典的 API 设计一般要么贴近页面内容，要么贴近数据模型。

贴近页面的 API 一个 endpoint 对应一个页面，其优势在于前端只需要一次请求即可拿到全部需要的字段，加载/错误状态处理非常简单，字段数据按设计图填充即可，汇总拼装数据的工作主要在后端完成。这种方式的缺点在于页面内容是随产品迭代经常修改的，这意味着每次需求变更都需要变更接口数据结构以适配页面变化。如果要无缝升级，要么给 endpoint 加版本号，要么确保只新增字段不修改、删除现有字段。

贴近数据模型的设计一般每个 endpoint 对应一个数据库里的一个表，汇总拼装数据的工作由前端完成。这种方式的优点在于数据模型相对页面更稳定，受需求变更影响更少，而且真有变更大都是加字段的行为，比较容易向下兼容；缺点是前端需要组织从多个 endpoint 加载数据，管理它们之间的依赖顺序，记录跟踪每个请求的状态、错误处理等，前端复杂度会增加不少。