我們很高興宣佈針對 SwaggerHub 的最新整合，這次是與 Atlassian 的原始碼控制管理平台 — Bitbucket 整合。此整合可協助開發人員讓 SwaggerHub 和 Bitbucket 上的資產保持同步和更新，因此在您的原始碼控制主機上工作的團隊可以從 SwaggerHub 取得您 API 的所有程式碼。
為何選擇 Bitbucket？
每位開發人員都知道原始碼控制的重要性，以及它如何讓軟體開發變得可管理且可迭代。但是您要將由原始碼控制工具管理的程式碼儲存在哪裡？ 無論是 Git、Mercurial 或 Subversion，原始碼控制主機都可以讓您與協作者在通用平台上儲存程式碼並進行協作，這是一個很棒的補充。 BitBucket 連同 GitHub 和 GitLab 一起，已成為原始碼控制託管環境中的主要參與者。BitBucket 已成為團隊託管程式碼的重要資源，其強大、安全的功能使其對組織和大型公司都非常有用。
那麼這對我有什麼意義？
雖然原始碼控制工具很適合託管程式碼，但它們並非用於編輯、設計和建構 API。 原始碼控制主機並非用於 RESTful 介面，而諸如 Swagger (OpenAPI) 規格之類的描述格式可協助建構這些介面。透過 SwaggerHub 與 Bitbucket 的整合，使用者現在可以無縫整合其 API 的文件和程式碼， 並讓其與 Bitbucket 上的儲存庫保持同步。
讓我們來看一個簡單的例子。
您組織的 API 團隊有多個團隊在您的 API 生命週期的各個層面工作。您會有架構師制定 API 的結構、伺服器端開發人員致力於為您的 API 建構穩固的後端，而面向用戶端的開發人員則專注於為您 API 的最終消費者設計絕佳體驗。團隊的測試人員專注於透過 DevOps 團隊進行品質保證，以便安全地部署 API。 所有這些團隊都有兩個共通點 —您的 API 和您團隊程式碼庫的主機。透過 SwaggerHub 與 Bitbucket 的整合，您現在可以同時更新上述兩者。這表示您團隊的工作流程將比以往更加順暢，並適合您的持續整合流程。 (SwaggerHub 也榮幸能提供與其他原始碼控制工具（例如 GitHub）的整合。您可以在這裡深入了解 SwaggerHub 中提供的所有整合。)
那麼我該如何開始使用？
首先，您需要在 SwaggerHub 上擁有 API 定義，並在 BitBucket 上擁有現有的儲存庫。 您可以免費註冊 SwaggerHub，並開始編寫您的 Swagger 定義，或匯入現有的定義。 一旦您擁有它們，請在 API 編輯器的頂角找到管理整合，然後選擇 Bitbucket 整合。 
接著您會看到幾個選項，以確切了解如何將您的 API 定義和正確的程式碼與您的儲存庫同步，包括程式碼種類（伺服器範本或用戶端 SDK）、儲存庫，以及您是否要讓 SwaggerHub 完全或部分管理您的儲存庫。 就是這樣！您的 API 定義和 SwaggerHub 的程式碼現在將與您的 Bitbucket 儲存庫同步，讓您的整個團隊可以協作！請參閱我們的 Bitbucket 說明章節，深入了解如何使用整合。 當然，SwaggerHub 有一套完整的整合，可建構在您 API 的功能之上，因此請隨意瀏覽我們的文件，其中詳細介紹了這些整合。 所以請前往 SwaggerHub 並試用此整合。歡迎將您希望在 SwaggerHub 上看到的任何新整合建議透過功能要求發送給我們。 不是現有的 SwaggerHub 使用者？免費註冊即可開始使用 SwaggerHub 建構更完善的 API。