管理API管理

API管理领域正经历着爆发式的变革。推动这些变革的因素包括传统的一体化解决方案正被API管理“去捆绑”方式所挑战，面向外部的API快速增加，专用工具领域不断拓展，以及AI和生成式AI逐步融入API项目。为了应对这股变革浪潮，制定一项完善的API战略至关重要，这将帮助企业在变化中保持竞争力。

技术领导者必须确保制定合理的API战略。本文提出了一个框架，用于开发与业务特点和市场需求相一致的API战略，从而满足企业的数字化需求。

技术战略旨在支持业务战略。关于数字产品的架构、工具和开发者参与度的技术决策，其重要性不亚于传统业务中的分销、包装和市场营销决策。技术领导者需要制定谨慎且创新的战略，既要有信心也要具备适应性。没有清晰的指导方针，企业可能面临过度支出、技术锁定、盲目追逐潮流、以及与业务不匹配的风险。

从底层追溯API成功，设计良好的API能够协同工作，有效交付业务能力。API管理为API开发者提供优质体验，为API消费者提供易于发现和使用的API，同时保证强大的安全性、主动的监控和预警，以及性能和运维的管理能力。这些都依赖于API管理工具和流程。最终，成功的API项目源自合理的API战略指导。

那么，如何建立一套良好的API战略？是否存在预设模板或实例？

本文提出了一个名为架构（Architecture）、实施（Implementation）、相关性（Relevance）的AIR框架，用于创建API战略。这个框架涵盖了API管理的所有方面，并将其与业务目标、市场趋势和技术趋势相结合。

架构
核心API应被统筹规划为一个中间层，提供业务能力和数据。应用程序有其架构计划，数据有其数据架构。这个框架强调，API架构同样至关重要，规划核心API是值得的投资。

传统上，API是在应用需求驱动下创建的。这个框架则建议企业主动创建一个涵盖核心数据实体和业务功能的API主架构。数据架构是对数据的安排，应用架构则是软件如何解决业务问题、交付业务流程的协调。API架构则是对核心API的规划，它们充当应用程序和数据之间的桥梁。

虽然这种方法类似于API优先的思路，但它更进一步。API优先意味着在解决业务问题时，首先考虑API，而这个框架要求预先设计能够代表核心业务能力的API架构。它需要考虑业务的差异化，了解业务伙伴和客户，掌握内部业务应用，以及数据等技术子架构的知识。

一个API架构将确定企业运营所需的最小API集，并可能为未来的API开发提供路线图。此架构还确定了组织对API粒度的偏好，这将影响应用程序的设计和灵活性。最终，这个架构明确了哪些API需要产品管理，并为其在开发过程中的权限提供保障。

实施
这是API架构的具体实施，即如何交付、保护、传达API架构，并为其规模化做好准备。AIR框架的这一维度涵盖了所需的基础设施、托管、访问管理、保护、API设计标准和API文档标准。

相关性
业务和技术环境始终在变化。API战略必须灵活，以适应业务和技术的变化。相关性维度关注API技术的关键方面，需密切监控并持续遵循当代实践。它帮助企业在技术趋势中进行优先级排序，指导企业在API创新中投入必要的资源，避免不必要的投入。

建立这些维度并回答相关问题，将形成一个层次结构，最终影响与API管理相关的所有决策，例如：

AIR框架提供了创建API战略的流程，帮助应对技术和业务趋势，并支持风险和成本分析。以下是如何实施AIR框架的一些建议：

业务能力模型
创建反映并支持业务能力的API架构。API是使内部系统和合作伙伴访问组织数据和功能的中间层，从根本上说，API就是组织的业务能力模型。

粒度和共享服务
像任何软件一样，API可能会趋向于单一化或过度分散。明确并执行适当的粒度对可用性、性能和演化性影响重大。复用往往被高估，其收益显而易见，但其成本却难以察觉。

产品管理
对于服务于顶层应用程序和终端用户体验的API，产品管理至关重要。自上而下的政策规定了API架构中需要产品管理的部分，以确保其存在并赋予其所需的权限。

保护责任
在API访问管理和保护方面，必须明确责任。保护政策还影响可持续性和扩展策略。

设计标准/指南
标准管理API设计，使工具自由，确保业务能力模型的对齐，并实现一致性带来的好处。设计标准将行业期望和组织偏好相结合，需得到组织内部的认同，并设有执行和可发展机制。

文档/发布政策
只有发布了文档的API才具有可发现性，只有可发现的API才能实现预期的采纳率并带来投资回报。文档和门户发布的政策确保API的可发现性。

AIR框架是一个提出的框架，目前尚无现成案例。然而，类似原则和方法的成功实践不乏其例。其中一个是福特Pro的API项目。

福特Pro的商用车辆高度互联，能够收集大量数据。由John Musser带领的福特Pro创建了一个SaaS产品，为客户提供数据和分析，帮助其最大化车辆性能和投资回报。

架构：福特Pro彻底架构了收集车辆数据所需的API以及向客户提供自主分析的API。
实施：福特定位为软件定义车辆（SDV）制造商。该API项目围绕物联网（IoT）、软件即服务（SaaS）以及Google Cloud Platform（GCP）的最新服务展开。
相关性：福特Pro的API项目需要与商用车辆领域的技术保持同步，同时遵循API最佳实践，为开发者和用户提供优质体验。

通过这些指导要素，福特Pro建立了API战略和项目，加速了福特向软件公司的转型。