SwaggerHub 的創建旨在改變團隊使用 Swagger (OpenAPI) 協作開發 API 的方式。 除了匯集開源 Swagger 工具的核心功能外，SwaggerHub 還提供一個中央平台，讓您可以託管和管理所有現有的 Swagger 定義，並與整個團隊協作設計和撰寫 API 文件。 自平台推出以來，我們從 SwaggerHub 用戶那裡聽到的最受歡迎的功能之一是能夠更好地組織不同內部團隊正在開發的 API。 對於這些團隊來說，SwaggerHub 已成為託管和探索所有現有 Swagger 定義的中央儲存庫。 隨著這些組織繼續擴展其 API 開發，越來越需要更好地組織不同團隊的 API 定義。 今天，我們很高興宣布推出專案，這是一種在 SwaggerHub 中組織團隊 API 的更佳方式。
專案的運作方式
直到今天，在 SwaggerHub 中組織 API 的最佳方式是使用組織。 組織允許您將所有團隊成員和共用的 API 分組在一個單一帳戶下。 組織的所有者可以輕鬆邀請團隊成員加入組織，並可以管理每個協作者對 API 的存取權限。 但到目前為止，組織的一個缺點是，每個成員都可以完全存取每個 API 定義，這使得管理團隊正在開發的越來越多的 API 有點複雜。 專案解決了這個問題 — 讓組織所有者建立名為專案的特殊資料夾，這些資料夾可以包含組織的選定數量 API 或網域（這些網域是可在多個 API 中重複使用的元件，以標準化 API 設計），並將這些專案指派給其組織內的不同成員或團隊。
專案如何協助改善您的 Swagger 工作流程
我們看到 API 團隊
從開源 Swagger 工具或商業協力廠商 API 開發工具轉換到 SwaggerHub 的最大原因之一是，很難追蹤組織內不同團隊在任何給定時間正在開發的不同 API 專案。 API 開發是高度反覆的過程，從設計到部署需要軟體開發團隊中利害關係人的意見。 專案提供了一種全新的方式來組織您的 Swagger 工作流程，並更好地管理參與協助您使用 Swagger 建構世界級 API 的人員。
如何在 SwaggerHub 中設定您的第一個專案
若要建立專案，您需要成為組織的
所有者。 請按照下列步驟執行
1. 選取 [建立新項目] > [建立新專案]
2. 命名您的專案
在下列畫面上，指定專案所屬的組織，並輸入專案名稱和任意描述 (最多 40 個字元)。
3. 選取 API 和網域
建立專案後，您可以將 API 和網域新增至其中。 您可以立即執行此操作，也可以稍後再執行。 若要新增 API 和網域，請按一下搜尋方塊內，然後從下拉式清單中選取 API 或網域：
若要更快地找到您的 API 或網域，請在搜尋方塊中輸入其名稱的任何部分。 SwaggerHub 會即時篩選下拉式清單。 您可以根據需要新增任意數量的 API 和網域。 如果您在清單上看不到 API 或網域，則很可能您的組織不擁有它。 在這種情況下，您可以跳過此步驟，並在將 API（或網域）所有權轉移給組織之後，稍後再將 API 或網域新增至您的專案。
4. 邀請成員
在此步驟中，您可以將使用者新增至您的專案。 您可以立即執行此操作，也可以稍後再執行。 若要立即邀請使用者，請按一下搜尋方塊內，然後從下拉式清單中選取所需的使用者：
請注意，清單只會顯示您組織的成員。 如果您在清單上看不到所需的使用者，則必須先將該使用者新增至您的組織。
5. 完成專案設定
將 API 和網域新增至專案並邀請使用者後，請按一下 [邀請成員] 頁面上的 [儲存]。 這會儲存您對 API 和使用者清單所做的變更。
請在此處閱讀 SwaggerHub 專案的完整文件。開始使用專案組織您的 API 開發
專案旨在符合需要維護和反覆執行大量 API 的 API 團隊的許多不同使用案例。 無論您是否有需要管理特定 API 專案的不同內部團隊，或是需要一種更好的方式來組織您
微服務架構中服務的所有不同 Swagger 定義，SwaggerHub 都可以提供協助。
立即登入以在 SwaggerHub 中開始您的第一個專案。 請務必讓我們知道您對新功能的看法。 請發送電子郵件給我們
[email protected]，或按一下 SwaggerHub 儀表板頂部的聊天圖示，與團隊成員聊天。