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 CEO 刘昊臻认为,要做 API 治理就要将 API 作为数字资产来管理。就像一个人如果要投资理财,就必须先清楚自己有多少可利用的资金和资源。何况 API 作为新时代最重要的数据和服务入口,值得企业和团队投入更多的精力来关注它。第一件事情就是要全面整理公司内部的 API 资产清单,否则后续的 API 治理工作都会化为空谈。
本文系外文翻译,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。
本文系外文翻译,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。