SwaggerHub 的創建旨在幫助團隊重新思考交付 API 的方式。
2017 年，超過 70,000 名 API 開發人員、設計師、技術寫手和產品經理開始使用 SwaggerHub。在這段時間內，我們深入了解 API 團隊大規模設計、記錄和交付 API 所需的條件。
我們也深入了解組織在多個團隊處理數百個 API 時面臨的挑戰。
諸如以下的挑戰
- 您如何確保每個參與者都能看見 API 的變更？
- 您如何在更新和版本化 API 的同時，確保文件保持最新狀態？
- 您如何確保 API 設計的一致性，並針對 API 的建置方式強制執行標準？
- 您如何發展您的設計流程，並採用像 OpenAPI 3.0 的新標準？
今年，我們發布了幾項新工具和資源，以協助解決 API 團隊面臨的這些和其他挑戰。我們也接觸 API 領域的業界領導者和創新者，以了解他們對於交付優質 API 的看法。展望 2018 年，我們想分享一些我們最佳的資源，並概述 SwaggerHub 的新功能，以協助您的團隊在新的一年取得成功。
團隊交付優質 API 的工具
我們在 2017 年初發布了三項新功能，旨在幫助團隊更好地管理其 API 設計和文件工作流程：用於設定和強制執行 API 樣式指南的「樣式驗證器」、用於檢閱和合併設計變更的「比較與合併」，以及用於在團隊中組織 API 的「專案」。
我們也發布與兩個領先 API 閘道器：Apigee 和 IBM API Connect 的新整合。
為了結束 2017 年，我們新增了對使用最新版本的 OpenAPI 規格 OpenAPI 3.0 設計和記錄 API 的初步支援。
規劃您的 API 策略
在 2017 年，我們持續看到越來越多組織採用產品管理原則來交付 API，並承認現代「API 經濟」的商機。我們也看到團隊越來越需要制定策略，以解決 API 從規劃和設計到文件、測試和部署的整個生命週期。
以下是一些規劃 API 策略的最佳資源
來自 API 產業的洞察
在今年，我們有機會接觸來自 API 領域各個領域的專家，以了解他們對 API 設計、協作等廣泛主題的看法，以及世界上一些最佳 API 團隊如何實施成功的 API 策略。
請查看我們以下最受歡迎的訪談
規劃和擴展您的 API 設計流程
像 OpenAPI（以前稱為 Swagger）這樣的描述格式越來越受歡迎，這也使得人們更加關注 API 開發的「設計優先」方法。因此，組織投入更多時間和精力來標準化其 API 設計流程，並設定 API 設計方式的要求。
透過這些資源了解如何標準化和擴展您的設計流程
透過 API 文件改善 API 開發人員體驗
API 文件是使用 OpenAPI 的團隊最大的使用案例之一，也是像 Swagger UI 這類工具如此受歡迎的主要原因之一。良好的文件有助於提高使用者採用率、減少支援查詢，並為使用您 API 的人員帶來更好的體驗。
今年，我們發布了許多資源，以協助初學者和經驗豐富的 API 團隊記錄其 API。
開始使用 OpenAPI 3.0
OpenAPI Initiative 是促進 OpenAPI 規格發展的組織，於 2017 年 7 月正式發布了該規格的最新版本。OpenAPI 3.0 是 Swagger 規格的下一個演進版本，除了正式獲得新名稱之外，還提供了改進和新功能，以協助團隊在其 API 的整個生命週期中利用該規格。
自發布以來，我們舉辦了三場培訓，並發布了許多新資源和文件以開始使用
您希望在 2018 年了解哪些 API 主題？請在下方評論中分享您的問題。