欢迎光临
我们一直在努力

API 共识化和 API 管理

API管理系统

API 去过哪里

让我们先回顾一下过去,看看 API 的需求最初是如何产生的,以及为什么 API 在历史上一直只是开发人员的领域。

The API as a Contract

api作为沟通

API 表示双方之间的契约。这两方是服务的提供者(有时称为服务器或发布者)和消费者(有时称为客户机)。API 是一个双方约定的接口(API 中的 I) ,双方将使用该接口进行通信。此接口包括有关如何访问 API (URL)、消息格式、可执行的操作以及通信的安全要求的规定。

Swagger Petstore 是遵循 OpenAPI 规范的 API 定义的典型例子。每个 API 端点都有一个明确定义的 URL 和请求方法,以及对安全性的要求和期望以及请求和响应的格式。

API 共识化和 API 管理-同济互联

在当今世界,通常期望通过 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 的开发人员的认可。从 C-Suite 涉众到产品经理,每个人都需要参与 API 的设计。这不再仅仅是高科技的领域。

需要战略思维来确保公司的 API (与“产品”同义)不会重叠并创建多余的功能。公司必须确保其所有原料药均符合下列准则:

  • 满足企业的销售需求。公司不应该销售顾客不愿意付费的产品。类似地,API 必须为公司带来实实在在的价值,积极地影响底线
  • 解决它所服务的竞争环境。就像产品一样,API 构建组织必须熟悉它们的竞争对手。API 提供什么价值主张?API 能够覆盖哪一部分客户,它是如何比竞争对手更有效地做到这一点的?
  • 是为了防止未来而设计的。新技术迅速涌现。数据隐私和安全规定是一个不断变化的目标。消费趋势从一个季度转向下一个季度。API 的设计是否能够承受和适应这些变化?

业务分析师不再能够简单地创建规范并将其交给开发团队。相反,必须采取更具规范性的过程,确保正在开发的 API 实际上满足企业各级的需求,无论是供内部使用还是供外部使用。

成功地交付 API 和基于 API 的应用程序现在需要每个人都有一席之地。这对公司意味着什么?这意味着需要采用能够促进这种民主化方法的工具和平台。这些平台将提供低代码或无代码 API 设计工具,授权利益相关者作为开发人员的共同试点。

筒仓式开发是过去的做法; API 民共识化正在取而代之。

API Management

这就把我们带到了 API 开发正在改变的下一个领域: API 管理策略。API 管理简化了跟踪公司发布的所有 API 及其版本、环境和用法的任务。

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

有了这样的规模和变化水平,单独使用源代码控制和电子表格不再可能管理 API。

拥抱“以 API 为业务”趋势的企业需要依赖能够处理现代 API 开发规模和范围的工具。API 管理工具可以帮助组织跟踪以下信息:

  • Versions 版本
  • Deployment environments 部署环境
  • Deployment locations 部署地点
  • Customers (API consumers) 消费者(API 消费者)
  • Usage metrics 使用率指标
  • Interoperability 互操作性
  • Relationships with other APIs 与其他 API 的关系
  • Dependencies 依赖性

API 管理工具还可以通过 API 网关和策略的实现、配置和管理提供更高水平的可靠性和安全性,例如,但不限于:

  • Rate limiting 利率限制
  • Traffic shaping 交通整形
  • Data masking 数据屏蔽
  • Various types of authentication 不同类型的认证
  • 甚至更多

虽然管理工具有很多种类,但最具影响力的是那些带有丰富 UI 分析的可视化工具,等等,同时仍然为 DevOps 团队提供 CLI 友好的功能。通过这种方式,团队可以在他们的技能集和首选方法的范围内工作,同时仍然清楚地了解和控制整个 API 生命周期中的工作流、 API 消耗和活动。

当我们考虑到当今企业对 API 的需求范围和规模时,手工和临时管理充其量是高风险和容易出错的。然而,有效的 API 管理工具可以简化和简化曾经令人生畏和不可能完成的任务。

新一代工具

Gravitee 是解决不断发展的 API 业务的新一代工具之一。Gravitee 平台包括一些工具,可以帮助任何组织实现有效的 API 民主化和管理。它的 API 设计器是一个协作工具,为 API 设计提供了一种流程图方法。业务涉众、产品经理和开发人员可以一起工作,将需求规范转换为高质量的 API 定义和数据模型。这对于选择采用设计优先方法开发 API 的团队尤其有用。

除了设计之外,API 网关和管理控制台还提供了以下特性:

  • Low-code/no-code policy configuration with a drag n’ drop policy studio 具有拖放策略工作室的低代码/无代码策略配置
  • The ability to implement API plans and contracts to manage and govern consumption 实现 API 计划和契约以管理和控制消费的能力
  • API documentation management API 文档管理
  • The ability to push APIs and their documentation to a consumer-facing Developer Portal 将 API 及其文档推送到面向用户的开发者门户的能力
  • The flexibility to mediate protocols and connect synchronous APIs (i.e. REST APIs) to asynchronous systems and APIs (i.e. a centralized Kafka backend) 协调协议并将同步 API (即 REST API)连接到异步系统和 API (即集中的 Kafka 后端)的灵活性

GraviteeCockpit 是一个基于云的工具,用于对企业的整个部署进行集中管理。使用 Cockpit,组织可以查看、管理和访问它们的 Gravitee 实例和环境,并且它们可以在这些不同的环境中推广 API。

结论

在过去的几十年中,应用程序开发已经从独立的、庞大的应用程序演变为分布式的、全球可访问的、云托管的庞然大物,它们可以成为企业的驱动力。在当今的 API 开发环境中生存和竞争需要组织的转变。这种转变包括采用促进原料药民主化和简化其管理的工具。随着组织开始使用这些工具,这只会提高其流程的效率并减少交付时间。

赞(0) 打赏
未经允许不得转载:同济互联 » API 共识化和 API 管理
分享到: 更多 (0)
API管理系统

相关推荐

  • 暂无文章

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏