尽管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

Logo

CSDN联合极客时间,共同打造面向开发者的精品内容学习社区,助力成长!

更多推荐