應用程式介面 (API) 已成為科技界的熱門流行語。越來越多的組織正在了解開發 API 程式以實現其策略目標的實際意義。在這種情況下，以一種對您的潛在使用者和客戶有意義的方式來更好地宣傳您的 API 的價值和優點非常重要。 我有機會與 Jennifer “Jen” Riggins，行銷顧問和 eBranding Ninja 的科技說書人坐下來，談論 API 從業人員之間的文化。Jen 是 API 領域著名的行銷人員和品牌顧問。身為 API 社群中少數沒有接受過正規技術培訓的說書人之一，她對 API 領域的文化提供了獨特的觀點，並討論了向廣泛受眾講述您的 API 故事的重要性。
API 創新的文化
Jen 認為，在過去十年中，人們對 API 的興趣大增，並且將在塑造我們的未來方面發揮重要作用。API 之所以能成為主流，部分原因在於 API 社群為宣傳和提高人們對投資 API 經濟的好處的意識所做的努力。這個社群由 API 供應商、從業人員和消費者組成，其特點是開放性和協作，這導致 API 領域的顯著發展。 開放性、透明度和求知慾的融合造就了創新的文化。這也有助於在短時間內在 API 領域普及的新技術數量不斷增加，從像 OpenAPI 規格 這樣的 API 定義格式，到像 Hypermedia 和 Graph 這樣的新架構。這種普遍的協作文化是開放原始碼社群的反映，因為很大一部分 API 從業人員都植根於開放原始碼專案。為了促進協作並促進更快的工程設計，像 SwaggerHub 這樣的 API 開發平台提供了 有利於團隊共同設計和記錄強大 API 的功能。 「科技領域的總體趨勢是賦予開發人員更大的權力，以便在軟體專案上進行更多協作。這是開放原始碼社群的基礎，現在在 API 社群中也看到了這一點。」Jen 說。 她說，API 社群非常歡迎和令人喜愛，允許成員在此過程中學習和成長。在開發和整合 API 的過程中，有來自不同背景和技能組合的人員參與，這為對話帶來了各種不同的觀點。Jen 還觀察到，隨著 API 意識的增強，社群的地域範圍也在擴大。 「這是一個非常虛擬的社群。部分原因是技術本身的性質，部分原因是它植根於開放原始碼社群。」 隨著 API 領域競爭的加劇，這種文化可能會發生變化。科技巨擘在發佈 API 文件和管理解決方案方面的投資大幅增加，這很可能會對 API 社群所代表的開放性和透明度的總體文化產生影響。
為什麼 API 需要好的說書人
Jen 提出了一個重要的觀點，即 API 行業缺乏良好的行銷。行銷是關於向正確的受眾講述正確的故事，以幫助他們在使用您的產品時取得成功。既然 API 的商業模式已經確立，那麼關注您如何有效地向目標市場講述您的 API 故事非常重要。由於 API 一直帶有技術傾向，因此大多數開發人員在行銷其 API 時，會專注於 API 的核心技術，而不是業務價值。 「該行業目前面臨的最大痛點是溝通。從根本上來說，開發人員仍然非常不擅長推廣他們的 API 並將其轉化為更廣泛的受眾。API 開發人員和供應商需要向他們的潛在客戶傳達其 API 的業務價值，以及它將如何使他們受益。」 Jen 繼續說道：「許多 API 文件和行銷甚至省略了 API 如何幫助用戶完成任務的基本摘要。」 她引用了幾年前 Andrew Seward 在 APIdays 的演講，他要求聽眾花一分鐘時間互相描述他們的 API。 「人們直接開始描述驅動這些 API 的語言和架構，完全跳過了它背後的業務價值。」Jen 說。 組織仍在努力解決的一個大問題是了解他們的核心受眾。API 的目標受眾僅僅是技術嫻熟的開發人員，他們會盡一切努力與您的 API 整合的時代已經過去。API 的受眾已擴展到產品經理、技術作家和行銷人員，他們希望使用透過 API 分發的服務來解決特定問題。如果 API 的價值和服務如何幫助解決目標受眾的痛點不明確，那麼它將對其採用產生不利影響。API 的目標受眾現在涵蓋了更大範圍的用戶角色，因為 API 已成為業務驅動因素，在您講述 API 故事時同情這些用戶角色是您成功的關鍵組成部分。 API 影響者正在引導對話朝著從業務角度有效地將您的 API 服務價值轉化為面向客戶的訊息的方向發展。一旦人們確定了業務價值，API 採用和追加銷售的問題就可以更好地緩解。 「良好的行銷必須從在您自己的業務和部門內成為更好的倡導者開始，然後您才能在 API 社群之外進行倡導。我們在宣傳和推廣 API 在科技領域的好處方面做得非常出色，現在是我們將這個故事告訴世界其他地方的時候了。」Jen 說。 Jen 認為，API 社群需要自己的明星，講述能夠引起世界其他地方共鳴的故事。像 Kin Lane（API 傳道者）、Lorinda Brandon 和 Arnaud Lauret（API Handyman） 等人一直在積極地向非技術受眾宣傳投資 API 程式的好處，但 Jennifer 認為我們需要更多。她說，為了提高人們對 API 經濟好處的認知度，我們不僅要更好地行銷 API，還要更好地行銷社群內彼此。
API 文件是您故事的延伸
API 文件如同您整體 API 訊息的延伸，專注於為您的使用者提供所有正確的資源，以順利開始並成功整合您的 API。Jen 認為此訊息必須滲透到您 API 產品的各個層面，而文件是此訊息不可或缺的一部分。良好的文件能滿足您的所有目標受眾，且由於您的受眾不只侷限於 API 經濟中的開發人員，因此務必優先處理並相應地最佳化您的文件。 但儘管文件是 API 採用最重要的轉換點，它始終是 API 生命週期中最不被重視的步驟，正如 Jen 在研究其2017 年 API 文件狀態報告時所發現的那樣。 相關連結：關於為實現最佳開發人員體驗而建立文件的免費線上研討會 「在採訪了數十位 API 影響者並撰寫 API 文件產業報告後，真正有趣的是文件中對人性的需求。在短時間內，人們對從 API 產生Swagger 文件感到滿意，但很快就意識到還需要更多。現在對於能同理行銷過程中真實人性問題的技術寫作者有很大的需求。」 從她與眾多實踐者的對話中，Jen 認為開始 API 文件流程的最佳方式是為您的 API 產生規範，這將成為具體且穩健文件的基礎。這可以使用任何流行的框架，如Swagger或 API Blueprint。對於產生基於舊版 API 的定義總會存在問題，您可以查看我們的免費資源，瞭解關於克服此問題的一些良好解決方案。產生此定義絕非最後一步。文件始終需要人性化，並且必須發展成全面的使用手冊，引導使用者完成 API 採用的每個階段。文件可以被視為一個產品，而 Jen 重申，客製化您的訊息和 API 文件以解決客戶必須解決的總體情境，可以極大地提升使用者滿意度。 「人們正在 Google 上搜尋您的 API，閱讀您 API 的價值主張和文件，如果他們無法開始使用您的 API，就會轉向其他人的 API。」 她認為要建立一流的文件，它必須成為 API 開發流程的一部分。Gareth Jones，Microsoft Graph API的首席架構師，在先前的對話中也呼應了這一點，即首先記錄客戶在使用您的 API 時可能面臨的總體情境，以此開始開發流程。透過這種文件或規範優先的方法，組織可以開始與各種試點客戶交流，瞭解如何改進這些資源以增加 API 使用量。將您的 API 文件視為一個獨立的一流服務，以協助使用者更快地整合您的產品，應該是一個策略優先事項。
產業的未來
Jen 認為 API 將引領許多新技術的發展，如人工智慧和物聯網。由於它們的互連性質，API 將成為眾多新創新的骨幹。 「所有正在發生的閃亮新事物，API 都是其骨幹。物聯網、人工智慧、機器學習和擴增實境 [AR] 都將透過 API 以某種方式提供服務。不斷有不同的創新湧現，並不斷發展，而 API 處於它們的中心，」她說。 隨著 API 經濟的來臨，以及新技術的出現速度比以往任何時候都快，對有效故事敘述的需求只會放大。 我對 Jen 的採訪是一系列 API 專家訪談的一部分。您是否希望我們與 API 專家探討某個主題？請在下方評論中告訴我們，或在推特上發送訊息給我們：@SwaggerHub。