[問答] 內部 API 開發者入口網站的重要性

  2018 年 6 月 26 日

Swagger 團隊最近前往德州奧斯丁參加Nordic APIs 奧斯丁高峰會。奧斯丁 API 高峰會為期三天,內容包含關於在 API 生態系統中建構成功的研討會和重要見解。在活動中,我很幸運有機會與幾位講者交流,以進一步了解他們所參與的工作,以及他們在 API 領域看到的機會和挑戰。

在這次訪談中,我採訪了 Kristof Van Tomme,他是 Pronovix 的執行長兼共同創辦人。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 團隊中,所以他們是開發人員,而且他們只想建立自己的東西。因此,您經常會看到這些「拼湊網站」,其中您有一堆不同的工具拼湊在一起。

沒有資訊架構。您最終會在不同的空間中點擊某些內容,而且您不知道您是如何到達那裡的,或者您確切地在哪裡。而且我認為這個領域只是缺乏成熟度。

很高興這次會議能讓我們作為一個社群聚在一起,並互相幫助解決這些問題。您說的完全正確,某些領域確實缺乏成熟度,但希望隨著我們在未來前進,這個問題將得到解決。

我認為已經有很多事情正在發生。我們正在推出「開發者入口網站獎」,我們希望這將有助於使每個人在對於開發者入口網站中重要的事項上達成共識。

現在,當您問人們:「什麼是好的開發者入口網站?」他們會說出相同的三個名字。他們可能有很好的經驗,但是感覺有點像人們困在這裡,而且人們只是重複他們聽別人說過的名字。我真的很想知道這些是否仍然是這個領域中最具創新性的公司。

而且開發者體驗還有很多不同的面向,而且我認為僅有三個範例是行不通的。在銀行業中,沙箱非常非常重要。對於其他一些行業而言,這並不是那麼重要。因此,關注這些不同的面向,並給予適當的關注,並且也認可和慶祝創新,我認為這對幫助生態系統向前發展很重要。

我完全同意!開發者入口網站獎聽起來非常令人興奮,它何時舉辦?

我們即將推出該網站。我們在巴黎舉辦的 API the Docs 會議上宣布了這一消息。下一次將在 11 月舉行。我們將在那裡宣布獲獎者。我們將在接下來的幾週內開始提名,其中包括大眾投票和評審團投票。我真的很期待看到結果。

我也很期待看到。最後一個問題是,您從本次會議中學到了什麼特別的見解?

我一直在思考模式語言。不知何故,感覺這次會議是我第一次真正對內部開發人員重要性這一主題產生共鳴。目前,這是我最大的收穫。有很多關於將 API 視為產品的討論,但這不是新事物,而且是我們之前已經看到的事情。目前大概在這兩者之間。

太棒了。非常感謝 Kristof,我真的很感謝您在百忙之中抽出時間與我交談。

謝謝您!

感謝您的閱讀!正在尋找更多 API 資源嗎?訂閱 Swagger 電子報。每月接收一封包含我們最好的 API 文章、培訓、教學和更多資訊的電子郵件。訂閱