API 持续改进:从理论到实践
1. API 产品基础与变更管理的重要性
API 产品工作基于 10 个支柱,每个支柱中的决策都会影响最终的 API 产品。不同支柱所需的工作量不同,需根据 API 的上下文和目标来确定各支柱的重要性。随着 API 数量的增加,还需考虑各支柱决策的分配方式。
管理 API 变更是成功的 API 管理策略的关键要素。对 API 进行更改会对软件、产品和用户体验产生重大影响。例如,一个代码更改若破坏了现有 API,会对使用该 API 的所有组件产生灾难性的连锁反应。即使不破坏 API 外部接口的更改,如果以意外的方式改变了 API 的行为,也可能导致大问题。而且,一个受欢迎的 API 可能会产生一长串依赖项,难以记录甚至难以察觉。
API 产品不仅仅是一个接口,它是由接口、代码、数据、文档、工具和流程等多个部分组成的集合。所有这些部分都可能发生变化,需要仔细管理。虽然 API 变更管理并不容易,但它是必要的,而且具有解放性。如果不允许对已部署的 API 进行更改,初始版本的发布将变得更加困难。而接受 API 的可更改性作为一个特性,可以带来巨大的回报。更便宜、更容易的更改意味着可以更频繁地进行更多更改,从而有更多自由去冒险,进而实现更多的 API 改进。
2. 持续变更管理的理念
支持 API 持续变更的目的是为了改进 API,而不仅仅是为了变更而变更。判断这种改进的两个关键方面是:一是改善开发者体验,二是降低产品赞助商的维护成本。并非每次变更都能立即改善 API 产品,例如为满足未来需求而改进 API 的扩展能力,这种变更可能在使用量增长之前不会带来直接的可衡量的改进,但可以防止未来体验的下降。任何变更都应
超级会员免费看
订阅专栏 解锁全文
171万+

被折叠的 条评论
为什么被折叠?



