31、API 景观之旅：从管理到成熟的全面指南

API 景观之旅：从管理到成熟的全面指南

1. API 景观的持续演进

API 景观如同互联网一样，处于持续的演进之中。互联网因新技术、新场景和新使用模式的不断涌现而持续发展，API 景观也必须随着业务和技术的发展而不断进化。景观架构需要响应不断变化的需求、原则、协议和模式。

然而，即使是最优秀的架构师也面临资源有限的问题，API 团队处理变化的速度也有上限。在当前景观作为 API 产品平台运行良好时，复用已有的原则、协议和模式可能比追求完美平台更经济。

理解 API 景观的成熟度意味着明确观察景观的要点，以及在何处和如何投资以改善景观。可以借助之前介绍的“八个 V”来评估不改进某些方面的风险，并指出改进方法。同时，还需要定义一些检查点，以更好地了解不同领域的成熟度水平，并确定投资方向，使各领域的成熟度更加一致。

2. 构建 API 景观的指导体系

创建和管理 API 指导是 API 景观管理的重要组成部分。指导应作为一份动态文档进行管理，让每个人都能阅读、评论和贡献内容，使开发者成为建立和发展该文档的社区成员。

为提高 API 景观的有效性，应严格区分 API 需求中的“是什么”“如何做”，并始终提供解释原理的“为什么”，同时为满足需求的具体方式提供工具和支持：
- “为什么”（指导动机） ：描述需求或建议背后的原理，避免规则不透明。记录原理有助于在提出替代方案时判断是否针对相同的原理。
- “是什么”（设计指导） ：解释解决“为什么”的方法，明确 API 需要做什么来解决相关问题。应通过定义 API 本身的明确需求，而