API管理:挑战与应对策略
1. API管理不仅仅是API本身
API的技术细节,如接口和实现,只是其中一部分。传统的设计 - 构建 - 部署元素对API的生命周期固然关键,但实际管理API还包括测试、文档编写以及将其发布到门户,以便目标受众(内部开发人员、合作伙伴、第三方匿名应用开发者等)能够找到并正确学习如何使用它们。此外,还需要确保API的安全性、在运行时进行监控,并在其整个生命周期内进行维护(包括处理变更)。这些额外的元素被称为API支柱,所有API和API项目管理者都需要处理这些方面。
这些实践领域的好处是,它们可以跨单个API应用。例如,编写良好API文档的技能可以从一个API团队转移到另一个团队,正确的测试技能、安全模式等也是如此。这意味着,即使为每个API领域(销售团队、产品团队、后台团队等)设置了单独的团队,也会有“跨领域”的利益将团队内的人员与其他团队的人员联系起来。
管理API的另一个重要方面是支持和组建构建API的团队。
2. API成熟阶段
理解API支柱并非全貌。每个API在项目中都会经历自己的“生命周期”,即一系列可预测且有用的阶段。了解自己在API发展过程中的位置,有助于确定当前应在API上投入多少时间和资源。理解API如何成熟,可以让你识别各种API的相同阶段,并帮助你为每个阶段不同的时间和精力需求做好准备并做出响应。
从表面上看,在设计、构建和发布API时,考虑处理所有API支柱是合理的。但实际情况并非如此。例如,对于早期阶段的API,最重要的是关注设计和构建方面,减少在文档编写上的精力投入。在其他阶段(例如,当原型交到测试人员手中时),花更多时间监控API的使用情况并防止其被滥用
超级会员免费看
订阅专栏 解锁全文

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



