API 治理旨在帮助人们通过 API 实现最大价值。但是,只有了解 API 是什么以及 API 的重要性,并且认识到 API 治理是在帮助他们而不是监管他们,才能实现这一目标。这就是为什么在任何 API 治理举措中都必须包括内部 API 倡导的关键原因。
一个 API 治理计划必须包括 API 倡导的三个方面:
- 提高 API 意识
- 揭秘治理并宣传它如何具体帮助
- 寻找中继和赞助商来放大信息。
一、提高 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,治理,Eolink,Apikit,倡导 From: https://www.cnblogs.com/apibest/p/17630970.html整理API资产一般分为几个步骤:
制定适合公司的 API 管理模式,比如,根据公司的部门、项目、服务进行分级管理。
通过 Eolink Apikit 快速导入已有的 API 资产,建立初步的 API 资产清单。
通过 Eolink Apikit 为 API 补充更详细的说明,尤其是热点 API(指目前仍在频繁使用或近一个月发生过改动的 API)。
为 API 建立标签系统,方便后续快速检索和测试。
对已经整理好的 API 项目创建一个版本快照,便于后续通过 Eolink Apikit 的版本管理功能来跟踪项目的API变更历史、及时回滚或者是进行API开发测试协作。
通过 Eolink Apikit 的数据看板,了解当前系统内的 API 管理情况。