我们很高兴宣布我们为 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。