研究和規劃是任何 API 專案成功的關鍵步驟。分析設計、開發和部署 API 的各種複雜性，以及伴隨行銷和營利的商業實務，有助於降低風險並提高成功的可能性。
Nordic APIs 是關於 API 所有相關資訊和資源的主要來源之一，從其開發背後的技術，到 API 消費的商業模式。Nordic APIs 擁有來自世界各地數千名 API 從業人員的受眾，已成為 API 領域中最知名的資源之一。
我很榮幸能與 Bill Doerrfeld，Nordic APIs 的總編輯，談論關於 API 程式成功的多個主題。我們談論了行銷 API 的挑戰、API 描述格式在使 API 更易於探索方面扮演的角色、技術行銷人員的興起等等。
您可以在下方閱讀我們的完整對話。
像 OpenAPI 這樣的 API 定義格式在 API 領域的地位持續提升。我們知道它們如何協助開發 API，但您認為 API 定義格式如何協助行銷 API？
API 描述格式獲得了高度的重視，並且對 API 的整個生命週期產生了重大影響。它們對於許多使用 API 的公司來說正變得更加確立和常識化。定義格式也使「設計優先」思維在該領域成為現實，這有助於更好地開發和使用 API 的體驗。圍繞描述格式建立補充工具也有助於它們的採用。
描述格式有助於使 API 更容易存取，因此更易於使用和行銷。格式透過文件產生、客戶端程式庫和開發人員套件等輔助工具，開啟了無限可能，所有這些都有助於 API 的推廣和採用。很高興看到作為一個產業，我們已經在OpenAPI 規格上標準化，讓我們所有人都能在 REST API 世界中擁有一種共同的溝通語言。
定義也使 API 在目錄中具有可攜性，從而為所有 API 創建一站式中心。
當我們談論行銷 API 時，我們經常聽到 API 目錄。目錄有多有效？開發人員真的會使用它們，還是他們堅持使用老式方法，只是在 Google 上搜尋內容？
目錄正變得越來越重要。像 ProgrammableWeb 這樣的網站以獲得大量關注而聞名，使其成為探索 API 的重要途徑。我聽過開發人員託管公共 API 的故事，他們將其添加到目錄中，並產生了潛在客戶。目錄實際上是一種潛在客戶產生機制，並且已知可以作為增加網路足跡的額外管道。一個很好的例子是 APIs.guru，它正在獲得廣泛的關注，並迅速成為 API 的維基百科。
雖然目錄對於人類來說很棒，但它們不是機器可讀的。這意味著一個廣泛的人性化目錄仍然會存在可移植到各種搜尋引擎的問題。這可能是將元資料與 Web API 關聯的最大優勢，因為它們確實允許搜尋演算法對其進行爬網。
API 仍然透過人工策展添加到目錄中，我希望未來，更多的 API 也能夠被各種爬網演算法自動索引。
行銷應該在 API 生命週期的什麼時候成為一個因素？這是在規劃期間就應該出現的事情嗎？開發階段？
答案將取決於組織希望如何利用其 API，以及它們作為一家公司有多開放。如果您是一家大型組織，您可能擁有內部資源，可以在任何事情公開之前執行大量測試。這些測試的結果將為行銷人員提供一些很好的見解，以及時間，在 API 公開之前確定正確的訊息、管道策略和採用模型。
如果是新創公司，可能沒有太多資源可以執行廣泛的 beta 測試。在這種情況下，明智的做法是讓行銷人員在 API 的規劃階段早期就參與對話，讓他們有時間確定達到採用目標的最佳行銷技巧。
您認為行銷 API 相關的挑戰有哪些？
向開發人員進行行銷是一件棘手的事情，因為他們往往很挑剔。他們需要以最快但最簡單的方式了解價值。通常，這種簡單性會轉化為訊息傳遞、登陸頁面的使用者介面，甚至是他們閱讀和解釋API 文件的方式。
行銷 API 在另一方面很困難，因為收入週期。您的組織需要一段時間才能從 API 直接找到一些有形的、可衡量的影響。這種價值可以是直接收入、品牌知名度或回頭客。API 和普通產品之間的一個很大區別在於價值創造的延長時間。
重要的是要了解 API 是高階整合，並且可以觸及公司架構中的許多重要組件。像 CPO、CTO 和 CFO 這樣的高層管理人員需要了解 API 可以帶來什麼價值。雖然這可能看起來這個領域變得更企業化了一點，但作為行銷人員，我們永遠不應該忘記我們真正的目標使用者 - 開發人員的需求。這就是為什麼文件在行銷人員的武器庫中如此重要，才能為 API 獲得新的使用者。
您會推薦哪些用於建立良好 API 文件的工具？
我最近做了一個30 種不同文件工具的回顧文章。我喜歡 SmartBear 的 Swagger UI；它在這個領域非常成熟，並且是許多公司已經使用的東西。我也喜歡 ReDoc，如果您喜歡三欄文件佈局，我也喜歡 Slate。
有一些很棒的開發人員入口網站，可以縮短開發人員使用 API 的時間。
您認為 API 和描述格式等技術的普及是否使行銷人員更加技術化？
不只是行銷，而是所有人。這是所有產業和職業的趨勢。每個人都需要變得更技術化一點才能保持相關性，包括行銷人員、作家和企業家。許多不同的人參與並對突破性、顛覆性技術感興趣，這也是我們可以對 API 所說的。雖然他們的頭腦並非完全在程式碼中，但他們仍然必須學習如何將它們應用於他們的日常活動中。
也許未來公司可能會招聘專門的「API 行銷人員」角色？
我認為這已經存在了，儘管他們稱他們為開發人員倡導者。不幸的是，行銷在開發人員的世界中聽起來不太好（笑）。
我們對 Bill Doerrfeld 的採訪是 Swagger 部落格正在進行的專家採訪系列的一部分。查看另一個與 Darrel Miller，OpenAPI Initiative 的熱門採訪。