[问答] 内部API开发者门户的重要性

  2018年6月26日

Swagger团队最近前往德克萨斯州奥斯汀参加Nordic APIs奥斯汀峰会。奥斯汀API峰会是一个为期三天的活动,内容包括研讨会和关于在API生态系统中取得成功的关键见解。在活动中,我有幸能与几位演讲者交流,了解他们所从事的工作,以及他们在API领域中看到的机遇和挑战。

在这次采访中,我与Pronovix的CEO兼联合创始人Kristof Van Tomme进行了交流。Kristof是一位开源战略家和架构师。Pronovix是一家专门为API项目提供开发者门户咨询服务的公司。

在奥斯汀API峰会上,Kristof在其题为《内部开发者门户:防火墙后的开发者参与》的演讲中,谈到了内部API需要更多内容,并分享了关于内部API开发者门户重要性的见解。

在我们的讨论中,我们谈到了Kristof对内部API开发者门户的热情,以及他与大型组织合作开发门户所学到的经验教训。

您可以在下方观看和阅读我们的完整对话。

你好,Kristof,感谢你今天抽空与我交流。你能告诉我更多关于你来奥斯汀API峰会的原因吗?

当我听说Nordic APIs要在奥斯汀举办活动时,我希望参与其中,因为我非常喜欢他们在斯德哥尔摩的活动!我认为这是一个很好的参与机会,也是在美国帮助发展的良机。

我正在努力推广内部API需要更多内容的需求,这主要是为了那些在内部防火墙后使用API的开发者。在我们与客户及其开发者门户合作的过程中,这让我们非常惊讶。我们原以为主要是向外部消费者进行营销。而大多数开发者门户仍然是关于外部营销的,因此我们所做的多数API门户都是为了公共API实现MVP(最小可行产品)。

这是让我非常投入和兴奋的事情。我喜欢寻找有重大需求的人,然后尝试帮助他们,并寻找尚未有人谈论的新问题。我认为这是一个大问题。

归根结底,我们是为开发者构建API,无论是内部工程师还是外部合作伙伴。你认为目前开发者门户领域最大的挑战是什么?

我认为最大的挑战是,到目前为止,人们对于合作伙伴真正需要什么还没有一个普遍的理解。我们最初是一家Drupal代理公司。我们已经在Drupal市场工作了近12年。感觉一方面,有网络代理公司,他们只是把这看作一个网站项目。另一方面,有围绕API构建业务的API公司,他们有自己的内部团队来做开发者门户。但这仅仅是关于他们自己的网站,从中无法提取出通用的模式。

我们一直在做的一件事是审视这个领域,试图弄清楚你需要哪些不同类型的内容;为此创建通用语言,以便我们能增进理解,并在该领域就所需的不同类型文档达成共识。

你需要迎合不同类型的用户,这不仅仅是针对开发者。也包括业务用户。营销很重要,你应该大方而不是操纵。还有很多理解需要建立。

除此之外,我认为大多数时候,你会看到构建开发者门户的人员都在API团队中,所以他们是开发者,他们只是想构建自己的东西。结果是,你经常会看到这些“拼凑网站”,其中有一堆不同的工具拼凑在一起。

没有信息架构。你最终会点击到某个不同的空间,却完全不知道自己是如何到达那里的,或者确切位置。我认为这个领域只是缺乏成熟度。

很高兴这次会议能让我们作为一个社区聚集在一起,互相帮助解决这些问题。你说的完全正确,有些领域确实缺乏成熟度,但希望随着我们未来前进,这些问题能得到解决。

我认为已经有很多事情正在发生。我们正在推出“开发者门户奖”,我们希望它能帮助大家就什么重要、什么对开发者门户至关重要达成共识。

现在,当你问人们:“一个好的开发者门户是什么样的?”他们会说出相同的三个名字。他们可能有很好的经验,但感觉人们有点困于此,只是重复着从别人那里听到的名字。我真的怀疑这些是否仍然是这个领域最具创新性的公司。

开发者体验也有许多不同的方面,我认为仅仅有三个例子是不够的。在银行业,沙盒(sandboxes)非常非常重要。对于其他一些行业,它就不那么重要了。因此,我认为关注这些不同方面,给予适当的重视,并认可和庆祝创新,对于帮助生态系统向前发展非常重要。

我完全同意这一点!开发者门户奖听起来超级令人兴奋,什么时候举办?

我们即将上线网站。我们已经在巴黎组织的API the Docs会议上宣布了它。下一次活动将在11月举行。届时我们将宣布获奖者。未来几周内我们将开始接受提名,通过大众投票和评审团投票。我非常期待看到结果。

我也很期待。最后一个问题是,你在这次会议中学到了什么特别的见解吗?

我一直在思考模式语言。不知怎的,感觉这次会议是我第一次在内部开发者重要性这个话题上获得了真正的共鸣。就目前而言,这是我最大的收获。有很多关于将API视为产品的讨论,但这并不新鲜,我们以前也见过。目前介于两者之间。

太棒了。非常感谢你,Kristof,非常感谢你在百忙之中抽空与我交谈。

谢谢!

感谢阅读!正在寻找更多API资源?订阅Swagger时事通讯。每月接收我们的最佳API文章、培训、教程等。 订阅

© . All rights reserved.