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

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资产一般分为几个步骤：

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

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

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

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

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

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