API 治理的目标是什么?

简介: 建立有效的API治理需要正确理解其目标,但它究竟是什么呢?是定义标准或规则并应用它们吗?都不是。虽然这些是治理的一个重要手段,但这并非其最终目的。为了揭示API治理的真正目标,让我们探讨一下在适当地制定标准后能得到什么。

建立有效的API治理需要正确理解其目标,但它究竟是什么呢?是定义标准或规则并应用它们吗?都不是。虽然这些是治理的一个重要手段,但这并非其最终目的。为了揭示API治理的真正目标,让我们探讨一下在适当地制定标准后能得到什么。


1. 从 API 混乱到一致性

API治理最显著的方面是定义设计标准,很多人认为这只是为了确保API之间具有一定程度的一致性,其实更重要的是评估它们的实际影响,我们来看看在没有有效标准时,设计师、开发者和提供商组织会遇到什么情况。

设计一个“搜索”的API操作可以有很多方法,如果没有共享的标准,两个设计师可能会花时间寻找如何设计“搜索客户”和“搜索产品”的操作方式,他们主要关注处理搜索过滤器、分页或如何对搜索结果列表进行建模。最后,在没有双方都能参考的标准下,这两个API操作将不具备相同的外观和行为特点,从而导致不一致。

当开发者使用“搜索客户”功能时,他们会分析该操作以弄清楚其工作原理。他们识别出诸如过滤器和分页处理方式或列表建模方式等设计模式,并据此编写代码。然后,在将调用“搜素产品”的功能集成到应用程序中时,由于尽管这两种操作都属于 “搜素”,但它们并未共享相同外观与行为特点, 因此需要再次执行以上步骤 。设计师之前学到的和编写的代码变得毫无用处,他们必须从头开始。这可能导致一些开发者选择不使用此类不一致的API,并寻找替代方案。

这种情况可能会出现在每个API的每个操作中。在提供商组织层面,交付并利用API将花费更多资金,阻碍组织推出新功能。如果API是公开的,那意味着收入减少。

因此,缺乏标准不仅导致了 API 间存在不一致性问题, 还对 API 设计师、消费者以及提供商组织财务产生了负面影响。


2. 给人赋能,并价值最大化

通过适当的API治理实施设计标准,其好处远不止于一致性,还包括:

  • 预定义的设计方案使设计工作更轻松: 设计师可以专注于关键问题以及API需要解决的具体问题,而不是在常见功能上反复浪费精力和时间。

  • 一致的设计模式使用户的工作更容易: 由于所有API调用都具有共同的外观和行为,因此将任何API调用集成到应用程序中变得简单快捷。这也让API更具吸引力。

  • 有效的标准可以使提供商获益更多: 交付更多功能所需时间较短,愿意使用API 的客户数量增加,这都会带来更高收入。

真正了解 API 治理就是要让人们受益,并最大化 API 的价值。除了 API 设计和标准之外,API 治理还可以涵盖很多其他事物, 如 API 产品定义、安全性和实现等。它可以采取不同形式,如自动化、研讨会或培训课程等。建立 API 治理时, 必须牢记所有这些内容, 否则可能效果欠佳、完全无效或甚至适得其反。


Eolink Aoikit 分析统计报表,API 治理情况一览无余。针对 API 设置各类自定义标签,如 API 的开发状态、负责人等信息,系统会自动自动统计并生成报表,方便随时了解项目状况。无论你使用什么语言开发,都可以帮您统一规范地管理起来,并提供强大的文档管理、协作、测试、分享功能。

微光计划20230704 无.jpg

Eolink 翻译,原文《What is the purpose of API governance?》,作者:Arnaud Lauret

相关文章
|
7月前
|
API 开发工具 开发者
全面的开发者文档和用户目标解析:API 文档指南和开发者旅程
开发者文档,也称为 API 文档,是一种专门针对软件开发人员的技术写作形式。这种类型的文档通常包括 API 的技术规范、代码注释、软件设计和架构以及软件开发中涉及的其他详细技术描述。开发者文档是开发人员的重要工具,因为它提供了使用和集成特定软件、库或 API 的必要指南、标准和示例。开发者文档的结构和内容的全面性会根据它所描述的软件的复杂性而大不相同,但主要目的是帮助开发人员理解、使用和高效地为软件做出贡献。
485 2
|
7月前
|
存储 安全 Devops
DevOps 中 API 治理的工程问题和落地实践案例
API 的全生命周期管理与 Devops 是紧密相关的,Devops 中的各个环节都会对 API 治理有一定的业务诉求,很多时候企业需要一体化的 API 管理平台来提供相应的业务能力。 在 Devops 工作流中进行 API 全生命周期管理时,成功交付的核心其实就是为企业提供工程问题的解决能力。那么所谓工程问题都有哪些呢?
219 0
DevOps 中 API 治理的工程问题和落地实践案例
|
人工智能 运维 Devops
AI 与智能化 API 治理的探索实践
1、API 作为一种核心的数字资产,要如何进行有效的管理并提升可观测性? 2、API 贯穿开发测试和运维等多个环节,我们要如何去把不同的团队和现有的工作流加以优化,并提升它的迭代效率? 3、API 作为核心的业务中间层,怎么样提升质量和安全性? 4、API 是否可以作为一种商品进行商业化?
367 0
|
架构师 API 开发者
为什么 API 治理需要内部倡导?
要做 API 治理就要将 API 作为数字资产来管理。就像一个人如果要投资理财,就必须先清楚自己有多少可利用的资金和资源。何况 API 作为新时代最重要的数据和服务入口,值得企业和团队投入更多的精力来关注它。第一件事情就是要全面整理公司内部的 API 资产清单,否则后续的 API 治理工作都会化为空谈。
98 0
|
API 计算机视觉 索引
【COCO数据集】COCO API 解析图像数据和目标标签,vision-transformer DETR的相关transforms操作实现
【COCO数据集】COCO API 解析图像数据和目标标签,vision-transformer DETR的相关transforms操作实现
456 0
|
运维 Cloud Native 测试技术
QCon 2022·上海站 | 学习笔记8: 喜⻢拉雅API治理实践
QCon 2022·上海站 | 学习笔记8: 喜⻢拉雅API治理实践
194 0
QCon 2022·上海站 | 学习笔记8: 喜⻢拉雅API治理实践
|
API Android开发
【错误记录】Google Play 上架报错 ( APK 大小 | 目标 API 级别 | Google Play 帮助文档 )
【错误记录】Google Play 上架报错 ( APK 大小 | 目标 API 级别 | Google Play 帮助文档 )
393 0
【错误记录】Google Play 上架报错 ( APK 大小 | 目标 API 级别 | Google Play 帮助文档 )
|
16天前
|
JSON API 数据格式
淘宝 / 天猫官方商品 / 订单订单 API 接口丨商品上传接口对接步骤
要对接淘宝/天猫官方商品或订单API,需先注册淘宝开放平台账号,创建应用获取App Key和App Secret。之后,详细阅读API文档,了解接口功能及权限要求,编写认证、构建请求、发送请求和处理响应的代码。最后,在沙箱环境中测试与调试,确保API调用的正确性和稳定性。
|
29天前
|
供应链 数据挖掘 API
电商API接口介绍——sku接口概述
商品SKU(Stock Keeping Unit)接口是电商API接口中的一种,专门用于获取商品的SKU信息。SKU是库存量单位,用于区分同一商品的不同规格、颜色、尺寸等属性。通过商品SKU接口,开发者可以获取商品的SKU列表、SKU属性、库存数量等详细信息。