API 治理的目标是什么?

API 小达人
• 阅读 363

建立有效的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 的开发状态、负责人等信息,系统会自动自动统计并生成报表,方便随时了解项目状况。无论你使用什么语言开发,都可以帮您统一规范地管理起来,并提供强大的文档管理、协作、测试、分享功能。

初创企业/团队点击可申请 Eolink Aoikit 免费使用

API 治理的目标是什么?

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

点赞
收藏
评论区
推荐文章
Chase620 Chase620
3年前
数据治理十步法
以下文章来源于谈数据,作者石秀峰1、找症状,明确目标任何企业实施数据治理都不是为了治理数据而治理数据,其背后都是管理和业务目标的驱动。企业中普遍存在的数据质量问题有:数据不一致、数据重复、数据不准确、数据不完整、数据关系混乱、数据不及时等。(https://imghelloworld.osscnbeijing.aliyuncs.c
天翼云供应链API安全治理实践获“优秀治理实践奖”
近日,由工业和信息化部网络安全管理局指导,中国信息通信研究院主办的首届信息通信软件供应链安全社区成员大会顺利召开。大会以“强化软件供应链安全治理助力信息通信业健康发展”为主题,旨在探索软件供应链安全治理模式,从根源上防范风险,促使安全治理工作得到真正落实并收获成效。大会现场公布了4类优秀成果评选结果,天翼云基于边缘云WAF实现API安全管理实践成果获评“优
API 小达人 API 小达人
1年前
改变数字经济的 10 大 API 趋势
根据谷歌2021年API经济状况报告,“公司报告称他们2021年主要优先事项包括关注API安全与治理(50%)、API增长和管理(41%)、投资建立开发者社区(38%)、通过API货币化产生收入(31%),使更多服务和数据公开可用(31%),以及增加对API操作和监控的投资(20%)”
API 小达人 API 小达人
1年前
为什么 API 治理需要内部倡导?
要做API治理就要将API作为数字资产来管理。就像一个人如果要投资理财,就必须先清楚自己有多少可利用的资金和资源。何况API作为新时代最重要的数据和服务入口,值得企业和团队投入更多的精力来关注它。第一件事情就是要全面整理公司内部的API资产清单,否则后续的API治理工作都会化为空谈。
分拣平台API安全治理实战 | 京东物流技术团队
导读本文主要基于京东物流的分拣业务平台在生产环境遇到的一些安全类问题,进行定位并采取合适的解决方案进行安全治理,引出对行业内不同业务领域、不同类型系统的安全治理方案的探究,最后笔者也基于自己在金融领域的经验进行了关于API网关治理方案的分享。写在前面随着互
E小媛同学 E小媛同学
11个月前
股东信息API:如何通过API获取企业股东构成的全貌
在当今数字化时代,信息的获取和分析变得至关重要,特别是对于投资者和企业决策者而言。股东信息是企业治理中一个关键的方面,了解企业的股东构成有助于投资决策、风险管理以及业务战略的制定。本文将探讨股东信息API,介绍如何通过API获取企业股东构成的全貌,并讨论这一过程对投资者和企业的重要性。
京东云开发者 京东云开发者
7个月前
【稳定性】稳定性建设之依赖设计
背景随着分布式微服务的发展,一个普通的应用可能会依赖于许多其他服务,这给系统的限流降级、优化改造等操作带来了困难。在没有明确强弱依赖关系的情况下,我们很难有效地进行这些操作。为了解决这个问题,强弱依赖治理成为了一种科学的手段。通过强弱依赖治理,我们可以持续
京东云开发者 京东云开发者
7个月前
稳定性方法论:可灰度 & 可监控 & 可回滚
业务系统核心目标是挣钱,系统稳定性建设核心是防止丢钱(丢钱逻辑如下图所示),站在公司的角度看,产品功能建设和系统稳定性是同等重要。前段时间写了《》,该文章在稳定性建设的理论和实践基础上,抽象出稳定性治理的框架,希望建立一个稳定性治理的标准动作、最佳实践。但
专注IP定位 专注IP定位
7个月前
什么是数据治理?你都了解吗?
在当今数字化时代,数据已成为企业重要的战略资产。有效管理数据对于企业提高运营效率、降低成本、做出更好的决策至关重要。数据治理作为一种重要的管理方法,可以帮助企业确保数据的质量、安全、合规性和有效利用。一、数据治理的定义与重要性近日,国家标准GB/T4369
专注IP定位 专注IP定位
6个月前
数据治理的五大误区与破解方法
在数字化转型的浪潮中,数据治理已经成了企业必不可少的一环。然而,许多企业在推行数据治理时常常陷入一些误解,这些误解阻碍了数据的有效管理和利用。那么究竟有哪些失误,又要如何解决呢?一、对数字治理的误解误解一:只有IT部门负责数据治理许多企业错误地认为数据治理