首页 > 其他分享 >为什么 API 治理需要内部倡导

为什么 API 治理需要内部倡导

时间:2023-08-15 11:55:37浏览次数:60  
标签:帮助 他们 API 治理 Eolink Apikit 倡导

API 治理旨在帮助人们通过 API 实现最大价值。但是,只有了解 API 是什么以及 API 的重要性,并且认识到 API 治理是在帮助他们而不是监管他们,才能实现这一目标。这就是为什么在任何 API 治理举措中都必须包括内部 API 倡导的关键原因。

一个 API 治理计划必须包括 API 倡导的三个方面:

  1. 提高 API 意识
  2. 揭秘治理并宣传它如何具体帮助
  3. 寻找中继和赞助商来放大信息。

一、提高 API 意识

如果人们不知道 API 是什么,或者没有理解 API 的重要性,以及认真对待 API 的好处和忽视 API 的严重后果,那么试图帮助人们有效利用 API 是无用的。

虽然 API 最初是一个 IT 话题,但 IT 团队并不总是完全理解它。让他们意识到从纯 IT 角度来看,API 如何帮助他们、减慢他们的速度甚至使他们的系统面临风险是至关重要的。同样重要的是让他们意识到,即使是私有 API,也可能会影响到他们组织的业务。

说到业务,与业务人员和高管谈论 API 也很重要。让他们理解有效利用 API 意味着更快的上市时间或更多的收入,应该会产生良好的效果。


二、揭秘、治理和倡导

除了提高意识外,与人们讨论他们通过有效利用 API 可以获得什么,不有效利用会失去什么,也是告诉他们 API 治理如何帮助他们的时刻,这是消除他们对 API 治理的误解都时刻——向他们展示您具体如何帮助他们。

告诉他们你提供哪些内部专业服务:例如 API 审查、设计研讨会或设计培训课程等。告诉他们在哪里可以找到关于避免和修复常见问题的 API 文档,或者在哪里可以找到完整的 API 指南。别忘了演示一下可供使用工具:例如,很多 API 问题都可以通过在设计过程中自动检查 API 定义来避免。

毫无疑问,当完成概念祛魅后,大家就很好接受。


三、寻找支持者和接力者放大信息

同样重要的是,由于 API 治理可能的影响力,治理在某些地方可能会受到欢迎。在这里你将找到精通 API 的开发者、技术负责人或架构师,他们已经应用了或愿意应用更好的实践,并且分享经验甚至为治理做出贡献。他们可能是告诉团队欢迎你并倾听你意见的管理者,也可能是会带来机会的商业人士和高管。所有这些人都将有助于提高对 API 的认识,并会证明有效利用 API 所能带来的价值。最终,会有越来越多的地方接受 API 治理,因为人们会学习别人的成功案例。


Eolink 一直向客户建议,如果要做 API 治理就要将 API 作为数字资产来管理。就像一个人如果要投资理财,就必须先清楚自己有多少可利用的资金和资源。何况 API 作为新时代最重要的数据和服务入口,值得企业和团队投入更多的精力来关注它。第一件事情就是要全面整理公司内部的 API 资产清单,否则后续的 API 治理工作都会化为空谈。

整理API资产一般分为几个步骤:

  1. 制定适合公司的 API 管理模式,比如,根据公司的部门、项目、服务进行分级管理。

  2. 通过 Eolink Apikit 快速导入已有的 API 资产,建立初步的 API 资产清单。

  3. 通过 Eolink Apikit 为 API 补充更详细的说明,尤其是热点 API(指目前仍在频繁使用或近一个月发生过改动的 API)。

  4. 为 API 建立标签系统,方便后续快速检索和测试。

  5. 对已经整理好的 API 项目创建一个版本快照,便于后续通过 Eolink Apikit 的版本管理功能来跟踪项目的API变更历史、及时回滚或者是进行API开发测试协作。

  6. 通过 Eolink Apikit 的数据看板,了解当前系统内的 API 管理情况。

标签:帮助,他们,API,治理,Eolink,Apikit,倡导
From: https://www.cnblogs.com/apibest/p/17630970.html

相关文章

  • 华为云API Explorer:自动化运维的得力助手
    华为云APIExplorer为开发者提供一站式API解决方案统一平台,集成华为云服务所有开放API,支持全量快速检索、可视化调试、帮助文档、代码示例等能力,帮助开发者快速学习API,使用API开发代码实现自动化运维。本文分享自华为云社区《深度开发者故事|华为云APIExplorer自动化运维的......
  • 上海/成都/深圳DAMA-CDGA/CDGP数据治理认证8月20日开班
    DAMA认证为数据管理专业人士提供职业目标晋升规划,彰显了职业发展里程碑及发展阶梯定义,帮助数据管理从业人士获得企业数字化转型战略下的必备职业能力,促进开展工作实践应用及实际问题解决,形成企业所需的新数字经济下的核心职业竞争能力。DAMA是数据管理方面的认证,帮助数据从业者提升......
  • .net6webapi中配置Jwt实现鉴权验证
    JWT(JsonWebToken)jwt是一种用于身份验证的开放标准,他可以在网络之间传递信息,jwt由三部分组成:头部,载荷,签名。头部包含了令牌的类型和加密算法,载荷包含了用户的信息,签名则是对头部和载荷的加密结果。jwt鉴权验证是指在用户登录成功后,服务器生成一个jwt令牌并返回给客户端,客户端在......
  • 企业治理
    企业治理构成组织的整个责任框架。企业治理有两个关键维度——符合性与绩效,这两个维度之间需要达到平衡。但是,它们经常会互相竞争资源。如果企业过于追求符合性(或合规性),绩效和效益实现状况通常会不佳;如果企业一味追求绩效而很少关注甚至忽视符合性,则面临可能严重影响企业生存的风险......
  • C# 获取网络API接口中的数据(1)
    控制台案例:usingSystem;usingSystem.Net.Http;usingSystem.Threading.Tasks;usingNewtonsoft.Json;usingNewtonsoft.Json.Linq;usingSystem.Data;usingSystem.Xml.Linq;usingSystem.Net;namespaceConsoleApp{classProgram{staticvoidM......
  • Apipost接口自动化控制器使用详解
    测试人员在编写测试用例以及实际测试过程中,经常会遇到两个棘手的问题:稍微复杂一些的自动化测试逻辑,往往需要手动写代码才能实现,难以实现和维护测试用例编写完成后,需要手动执行,难以接入自动化体系这里,小编在Apipost自动化测试中还原了用户在电商平台购物实例,并利用这个实例来给大家......
  • Apipost接口自动化控制器使用详解
    测试人员在编写测试用例以及实际测试过程中,经常会遇到两个棘手的问题:•稍微复杂一些的自动化测试逻辑,往往需要手动写代码才能实现,难以实现和维护•测试用例编写完成后,需要手动执行,难以接入自动化体系这里,小编在Apipost自动化测试中还原了用户在电商平台购物实例,并利用这个实例来......
  • 图解 history api 和 React Router 实现原理
    Router是开发React应用的必备功能,那ReactRouter是怎么实现的呢?今天我们就来读一下ReactRouter的源码吧!首先,我们来学一下HistoryAPI,这是基础。什么是history呢?就是这个东西:我打开了一个新的标签页、然后访问baidu.com、sougou.com、taobao.com。长按后退按钮,就会列出......
  • 一文详解Apipost数据模型功能
    在Apipost数据模型中用户可以预先创建多个数据模型,并在API设计过程中重复利用这些模型来构建API创建数据模型在左侧导航点击「数据模型」-「新建数据模型」在右侧工作台配置数据模型参数 引入数据模型在API设计预定义响应期望下点击引用数据模型,并选择需要导入的数据模型......
  • API接口对接电商平台高效获取各大电商平台数据,商品详情数据代码示例
     电商可以通过使用API接口获取商品信息数据。API是应用程序编程接口的缩写,它允许程序之间进行通信和数据传输。为了获取商品信息数据,电商可以利用API接口向商品供应商的数据库发送请求,然后接收并解析返回的数据。具体来说,电商可以按照以下步骤利用API接口获取商品信息数据:1.找......