API 共创时代：管理与协作新模式

API 共创的由来

如果你是一名程序员或者互联网行业的从业者，那么你一定非常熟悉 API，你甚至是某个 API 的贡献者或者参与人员之一。在之前，大多数程序员构建 API 是为了满足应用程序的需求，但现在，应用程序的开发者正在专门围绕 API （这些 API 可能是开放或者免费的）进行应用程序的设计和开发，这种开发模式跟过去的研发方向恰恰相反。

正因为如此，随着 API 的使用、开发和产品化迅速发展，越来越多不同岗位职能的人加入到 API 创造当中，并逐渐形成了一个新趋势：API 共创。

简而言之，API 的构建将不再单单是开发者的个人领域，而是整个企业团队成员一起共同参与开发的产品。

API 的规范性

在详细讲 API 共创之前，我们先来了解一下 API 的规范性，这对于我们为什么可以实现 API 共创至关重要。

API 代表服务器和客户端之间的纽带，是双方将用于通信的商定接口（API 中的 I）。该接口包括有关如何访问 API（URL）、消息格式、可以执行的操作以及通信的安全要求的规定。

以 Apifox 的接口为例，是符合 OpenAPI 规范的 API 定义的典型示例。每个 API 端点都有明确定义的 URL 和请求方法，以及对安全性的要求和期望以及请求和响应的格式。

我们通常期望可以通过 SOAP 或 REST 等样式或协议访问 API。在当今时代，很多人认为 API 主要是在 Web 服务中使用。然而，几十年前，一个应用程序中的不同组件都是用 API 来促进彼此之间的通信。

当时，API 只是用于抽象应用程序不同层的代码库。

随着 Web 2.0 的成熟和云计算成为常态，API 的使用得到扩展，标准化了不同黑盒应用程序之间的通信方式。通过使用 API 来指定不同服务的通信方式，这些服务的实现细节（包括所使用的编程语言或框架）从而变得无关紧要。

这意味着只要我们定义规范良好的 API，就可以让所有不同类型的服务都可以协同工作，这将大大提高 API 的可扩展性。而正是基于此，API 共创才能得以发展开来。

API 共创与管理

在以前，API 的需求是由产品经理或者相关负责人提出需求，而开发人员负责 API 的设计和构建；因此开发人员是唯一真正了解 API 开发内容的人，这种开发模式本身并没有什么问题；但是随着 API 开发业务的转变，整个应用程序，在某些情况下，甚至整个业务，都在围绕 API 套件构建。API 团队化协作带来了对两个新的需求：API 共创和管理。

API 共创

我们刚才谈论了过去的团队协作方式：开发人员独立维护和响应 API 的整个生命周期，包括从设计、构建、维护，这个过程全部依赖于开发人员去完成。

但是如果这个 API 涉及到企业的重要业务，那么无论是从 API 的设计或者构建，都应该让业务相关的人员，比如产品经理、项目负责人等参与进来。从这时起，API 设计就不再是开发人员的个人领域了，而是整个团队的人一起构建一个 API，我们可以称这种协作模式为 API 共创。

为了避免 API 或者说是整个产品功能，不会重叠并产生冗余功能，各职能岗位在参与构建 API 的时候，需要考虑到是否符合下面这些标准：

• 销售：API 必须为公司带来有形价值，对利润产生积极影响，从而满足企业的销售需求。
• 产品：了解竞品，就像产品一样，API 构建团队必须熟悉他们的竞争对手。API 提供什么价值主张？API 覆盖了哪些客户群？ 比竞争对手有什么优势？
• 技术：设计时考虑面向未来的需求。新技术迅速涌现，数据隐私和安全法规是一个不断变化的目标，API 的设计是否能够承受和适应这些变化？
• 管理：必须进行更加规范的流程，以确保正在开发的 API 实际上满足企业各个级别的需求，无论是供内部还是外部使用。

一个成功交付的 API 和基于 API 的应用程序现在需要每个人都参与进来。这对公司意味着什么？这意味着需要采用可以促进这种开放、平等的方法的工具和平台，使非开发者能低门槛地学会管理和了解当前正在设计的 API。闭门造车式的开发模式已经成为过去，API 共创模式正在取而代之。

API 管理

API 共创将我们带到 API 开发正在发生变化的下一个领域：API 管理策略。如何高效便捷的追踪团队发布的所有 API 及其版本、环境和使用情况等信息，是 API 管理中最重要的一点。

今天的企业构建的应用程序可能依赖于成百上千个 API。这些 API 被部署到内部数据中心和多个云提供商，其中一些可供公众使用，而另一些则只有特权或私有的内部访问权限。某些 API 甚至可以针对特定消费者进行定制。此外，每个 API 可能有多个支持的版本。

有了这种级别的规模和变化，不再可能仅使用源代码控制和电子表格来管理 API。拥抱“API 即业务”趋势的企业需要依赖能够处理现代 API 开发规模和范围的工具。API 管理工具可以帮助组织跟踪以下内容：

• 版本
• 文档管理
• 互操作性
• 依赖关系
• 时效性

在以往，难以有一款工具可以全面覆盖这些新发展出来的需求，而现在，我们可以通过使用 Apifox 来轻松管理大量的 API 接口。Apifox  带来的可视化操作界面，大大节省了 API 构建、管理的时间，无需再切换不同的工具去完成一个 API 的相关任务。围绕应用程序开展的 API 都可以集中在一个项目内，也可以随时邀请团体的其他成员共同参与，这无疑是API 共创和管理的最佳结合方式。

结论

实现 API 共创和管理是新型团队的协作模式，随着应用程序开发已经从独立的整体式应用程序发展为分布式、全球可访问、云托管的庞然大物，这些庞然大物可以成为企业的驱动力。要想在当今的 API 开发环境中生存，需要团队进行转型，这种转型包括采用促进 API 共创并简化其管理的工具。随着世界各地的团队开始使用这些工具（如 Apifox），相信会有效地提高他们的流程效率并缩短项目交付时间。