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

  2018 年 6 月 26 日

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

在本次采访中,我采访了 Kristof Van TommePronovix 的首席执行官兼联合创始人。 Kristof 是一位开源战略家和架构师。 Pronovix 是一家专门为 API 项目提供开发者门户咨询的公司。

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

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

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

嗨,Kristof,感谢您今天抽出时间与我交谈。您能多告诉我一点是什么让您来到奥斯汀 API 峰会吗?

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

我正在努力推广对内部 API 更多内容的需求,这适用于在内部防火墙后使用 API 的开发人员。在我们与客户及其开发者门户的合作中,这对我们来说是一个非常大的惊喜。我们认为它主要是针对外部消费者的营销。而且大多数开发者门户仍然是关于外部营销的,因此我们所做的大部分 API 门户都是关于为公共 API 获得 MVP 的。

我对此感到非常热情和兴奋。我喜欢寻找有很大需求的人,然后尝试帮助他们,并寻找尚未有人谈论的新问题。我认为这是一个大问题。

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

我认为最大的挑战是,到目前为止,还没有人普遍了解合作伙伴真正需要什么。我们最初是一家 Drupal 机构。我们已经在 Drupal 市场工作了近 12 年。感觉一方面,你有 Web 机构,他们只是把它当成一个网站项目。然后另一方面,你有一些 API 公司,他们围绕 API 构建了自己的业务,他们有自己的内部团队在做他们的开发者门户。但这只是关于他们自己的网站,而且没有任何可以从中提取的通用模式。

我们一直在做的事情之一是关注这个领域,试图弄清楚你需要哪些不同类型的内容; 为此创建通用语言,以便我们可以提高理解,并在该领域就您需要的不同类型的文档达成共识。

您需要满足的不同类型的用户,而且这不仅仅是关于开发人员。它也关于业务用户。营销很重要,而且你应该慷慨,而不是操纵。有很多理解需要建立。

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

没有信息架构。您最终会点击某个不同空间中的某个东西,而且您不知道自己是如何到达那里或您确切地在哪里。而且我认为这个领域只是缺乏成熟度。

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

我认为已经发生了很多事情。我们正在启动“开发者门户奖”,我们希望这将有助于让每个人都了解什么是重要的,对开发者门户来说什么是重要的。

现在,当您问别人:“什么是好的开发者门户?”他们会说出相同的三个名字。他们可能有很好的经验,但感觉有点像人们被困在这种状态下,人们只是在重复他们听其他人说过的名字。我真的很想知道这些是否仍然是该领域最具创新性的公司。

而且开发者体验也有很多不同的方面,而且我认为只有三个例子是不行的。在银行业,沙箱非常非常重要。对于其他一些行业来说,这并不重要。因此,关注这些不同的方面,并给予适当的关注,并认可和庆祝创新,我认为对于帮助生态系统向前发展非常重要。

我非常同意!开发者门户奖听起来非常令人兴奋,它什么时候举行?

我们即将推出该网站。我们在巴黎举办的 API the Docs Conference 上宣布了这一消息。下一次将在 11 月举行。在那里,我们将宣布获奖者。我们将在未来几周开始进行提名,包括公开投票和评审团投票。我真的很兴奋看到会发生什么。

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

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

太棒了。非常感谢 Kristoff,我真的很感谢您从繁忙的日程中抽出时间来和我谈话。

谢谢!

感谢您的阅读!正在寻找更多 API 资源?订阅 Swagger 新闻通讯。每月收到一封电子邮件,其中包含我们最好的 API 文章、培训、教程等。订阅