尽管api已经存在了50多年，但它们只是在最近10年左右才成为主流，围绕这项技术产生了大量的讨论和兴趣。拥有api有很多优点，无论是面向公众的还是内部的。然而，在开始成功的API之旅时，各种组织和团队仍然会遇到困难和问题。我最近与Eolinker的朋友坐下来讨论了许多关于api以及不同团队应该如何看待api的问题。Eolinker是一家专注于api的开发和管理服务公司，帮助客户通过api交付新的业务价值。他们为公司和组织如何实施API战略提出了宝贵的见解。

构建成功的API

对Eolinker来说，一个成功的API需要像对待公司产品组合中的任何一流产品一样小心和关注。 “理解和真正的产品管理对使用API的开发人员的同理心，就像你对任何客户的同理心一样，在设计一个伟大的API以使其被采用方面有很长的路要走。”

在处理api时应用产品管理原则和实践是将api视为一流产品的第一步。产品经理了解他们的终端客户。这同样适用于api。理解API的最终消费者的需求，并了解API如何适应他们的软件开发生命周期，对于构建一个可靠的API至关重要。在API开发和部署生命周期的每个阶段都考虑到终端用户的需求，有助于将API的开发引向正确的方向。 然后是用户体验同理心。设计API及其周围的构件和服务，以减少预期使用者的学习曲线应该始终是最优先考虑的事项。将最终用户考虑在内构建api是设计思维方法的基础。设计思维试图在终端消费者、业务和技术之间找到平衡。 同样的道理也适用于API，理想情况下，设计良好的API会找到这种最佳平衡。这意味着业务价值是随着API使用的增加而产生和驱动的，实现的技术是没有错误的，并且符合可接受的标准。通过正确平衡产品管理和用户体验原则，最终消费者可以很容易地采用和使用API。就像任何产品一样，被接受就会被接受。对于公共api来说尤其如此。我们经常看到，如果社区从api中获得了很多价值（从构建文档到开发客户端sdk），他们就会加快步伐，为api的采用做出贡献。

更新速度是重要的考虑因素吗?

对发行日期做出准确的估计是很重要的。通常情况下，要在快速推向市场和api设计的一致性之间做出权衡。尽管快速上市很重要，但它不应该导致API的第一个版本的效率低下和设计糟糕。为此，Eolinker建议确定一些最初的目标用户，并在API的开发阶段尽可能多地获得他们的反馈。这将允许一个良好的API第一次发布，同时仍然满足发布截止日期，收集用户反馈的创新方法并不稀缺。

要注意错误

这种策略的一个常见错误是，组织只根据这些初始客户的需求来定制API，希望API具有通用性，能够满足整个市场的需求。然而，事实证明，这些共性会导致更多的差异。因此，建议对这些初始客户的反馈采取开放的态度。 有一个具体的版本控制策略也可以帮助克服这个问题。 “组织需要制定一个可靠的计划，告诉他们何时以及如何对API进行新的修改，从而随着时间的推移迎合更大一部分终端消费者的需求。”

如果一个组织想要遵循一个理念，那么上市时间就会有所变化。让我们以超媒体API为例，它是API标准的新级别。虽然发布基于超媒体的API可以带来很多好处，但组织需要绝对确保终端客户具备使用这些API的成熟度和专业知识。记住，通过采用新标准，发行商也希望他们的终端用户具有一定程度的理解力。 “虽然他们可能在社交领域或数字用户体验领域拥有技术或尖端产品，但其中一些公司已经经历了漫长的旅程，可能仍在将其API提升为一流公民产品的旅程中。”

何时采用“设计第一”的方法

如果组织足够成熟，能够实现理念，那么设计首先是有意义的。正如我们在聊天中所解释的那样，有很多情况下，API的设计被提出并决定，API的开发就开始了，但是设计在开发过程中不断更新。 这并不是一个孤立的项目，如果不同团队之间的沟通不够强，这种情况会经常发生。这种偏移只会增加团队的工作量，在某些情况下，还会导致团队之间产生许多挫折感、敌意和不信任。如果团队将API的设计提供给开发团队，让他们在实现API时领先一步，那么他们需要与开发团队进行开放的沟通，并且需要存在大量的信任。 虽然像OpenAPI规范（以前称为Swagger规范）这样的描述格式、RAML和API蓝图确实满足了一个很好的需求，但将开发视为“设计优先”或“代码优先”需要更多的思考。因此，经历API的旅程并找出哪种方法适合您的开发团队是很重要的，因为理论上的理想并不总是实践中最好的。 我们多次说到了设计一致的重要性。不管构建api的方法如何，组织下针对不同产品和服务的不同api应该具有相同的内部指导原则。最终开发人员应该觉得该组织提供的所有api都是由同一组织构建的。即使这些api不相互交互，这也是正确的。 例如，像谷歌这样的公司，为YouTube、谷歌+和谷歌地图等多个不相关的产品提供api，仍然可以遵循一些既定的内部标准，帮助开发者轻松地适应他们的api。这种一致性的陈述是Eolinker会向他所有的客户推荐的。

衡量成功

API投资的挑战之一是认识到ROI是无形的资产。API投资的成功程度可以通过组织获得重复业务的频率、合同更新的频率以及组织产品和服务的受欢迎程度来衡量。所有这些自然都会带来增长和收入，事后看来，高管们常常会意识到，这是由于公司投资将api视为一流产品。另一个衡量成功的标准是用户接受度。你需要花大量的时间在你的api的用户体验上。克里斯和他的团队衡量的一件事是“hello world”的时间。这是API的最终使用者成功调用所需的时间。文档和代码示例越好，最终用户验证和调用API所需的时间就越少。

设定正确的期望

对于组织来说，重要的是要认识到，使用他们发布的API也涉及到客户方面的成本和努力。这些api还将与其他公开类似服务的api和产品竞争客户的资源。因此，一旦你的API构建完成，期望用户会自己开始使用它并不是正确的方法。 像其他任何产品一样，API需要花费时间和精力才能达成目标用户的成功，采用一个api的时间比很多人认为的api要长，在国外，最成功的api也需要3-5年的时间才能达到现在的流行程度。无论是获得采纳，还是承诺api的支持和维护，api的各个阶段都有总拥有成本，要实现正确的成功还有很长的路要走。 “不同的公司可能处于API生命周期的不同阶段，期望他们以相同的势头到达终点是不现实的。” 最终，每个API都试图解决终端用户的痛点。将价值归因与痛点捆绑在一起，以及API提供的解决方案，最终将使其在技术和业务层面取得成功。

api的未来

Eolinker认为，人类与机器交互的界面将会淡出人们的视野，计算机将变得无处不在，也不可见。在过去的几十年里，我们已经看到了界面的显著变化，从第一台电脑的巨大盒子，到我们口袋里携带的7英寸屏幕的iphone。同样的道理也适用于api，最终开发人员使用api时，会出现更好、更有趣的接口。

想了解更多吗？

如果你有兴趣了解更多关于Eolinker的信息，可以关注查看他们的网站并尝试使用：www.eolinker.com