那次小型的 API 清理在后来拯救了我们
在后端工作中,我不断重温的一件事是:混乱的 API 名称在后期付出的代价比最初的 Bug 更大。 在一个项目中,我们有三个端点返回相同的客户对象,但字段略有不同。它起初运行良好,直到移动应用开始缓存一种形状,而 Web 端期望另一种形状。修复方法并不花哨:一个序列化器,一个默认值存放处,以及一个针对真实路由的小型契约测试。 这花了大半天时间。但当产品经理下次要求增加一个新字段时,它节省的时间远不止这些。
在后端工作中,我不断重温的一件事是:混乱的 API 名称在后期付出的代价比最初的 Bug 更大。 在一个项目中,我们有三个端点返回相同的客户对象,但字段略有不同。它起初运行良好,直到移动应用开始缓存一种形状,而 Web 端期望另一种形状。修复方法并不花哨:一个序列化器,一个默认值存放处,以及一个针对真实路由的小型契约测试。 这花了大半天时间。但当产品经理下次要求增加一个新字段时,它节省的时间远不止这些。