SwaggerHubの最新の統合を、今度はAtlassianのソース管理プラットフォームであるBitbucketと共にお知らせできることを大変嬉しく思います。この統合により、開発者はSwaggerHubとBitbucket上のアセットを同期させ、最新の状態に保つことができます。これにより、ソース管理ホストで作業するチームは、SwaggerHubからのAPIのすべてのコードを利用できるようになります。
なぜBitbucketなのか？
すべての開発者は、ソース管理の重要性と、それがソフトウェア開発をいかに管理しやすく反復的なものにするかを知っています。しかし、ソース管理ツールで管理されるコードはどこに保存しますか？ Git、Mercurial、Subversionのいずれを使用しても、共同作業者と共通のプラットフォームでコードを保存し、作業するためのソース管理ホストは非常に役立ちます。 BitBucketは、GitHubやGitLabと共に、ソース管理ホスティング環境で主要なプレーヤーとして台頭してきました。BitBucketは、強力で安全な機能を備えており、組織や大企業にとって非常に役立つリソースとして、チームがコードをホスティングするための優れたリソースとなっています。
それは私にとって何を意味するのか？
ソース管理ツールはコードのホスティングには優れていますが、APIの編集、設計、構築には適していません。 ソース管理ホストは、Swagger（OpenAPI）仕様のような記述フォーマットが構築を助けるRESTfulインターフェースには適していません。SwaggerHubのBitbucketとの統合により、ユーザーはAPIのドキュメントとコードをシームレスに統合し、Bitbucket上のリポジトリと同期させることができます。
簡単な例を見てみましょう。
あなたの組織のAPI部隊には、APIのライフサイクルのさまざまな側面に取り組む複数のチームがあります。APIの構造を設計するアーキテクト、APIの堅牢なバックエンド構築に取り組むサーバーサイド開発者、APIのエンドコンシューマーに優れた体験を提供するクライアント向け開発者がいます。DevOpsチームと連携して品質保証に焦点を当てるチームのテスターは、APIを安全にデプロイするために作業します。 これらすべてのチームには、2つの共通の分母があります — APIとチームのコードベースのホストです。SwaggerHubとBitbucketの統合により、上記の情報を同時に更新できるようになりました。これにより、チームのワークフローがこれまで以上にスムーズになり、継続的インテグレーションプロセスに適合します。 （SwaggerHubは、GitHubのような他のソース管理ツールとの統合も提供していることを誇りに思っています。SwaggerHubで提供されているすべての統合の詳細については、こちらで確認できます。）
どのように始めるのですか？
まず、SwaggerHubにAPI定義、BitBucketに既存のリポジトリが必要です。 SwaggerHubに無料でサインアップして、Swagger定義の作成を開始するか、既存の定義をインポートできます。 それらが揃ったら、APIエディタの右上隅にある統合の管理を見つけて、Bitbucket統合を選択します。 
次に、APIの定義と適切なコードがリポジトリとどのように同期されるかを示すいくつかのオプションが表示されます。これには、コードの種類（サーバーテンプレートまたはクライアントSDK）、リポジトリ、そしてSwaggerHubにリポジトリを完全にまたは部分的に管理させるかどうかが含まれます。 それだけです！SwaggerHubからのAPI定義とコードは、Bitbucketリポジトリと同期され、チーム全体で作業できるようになります！Bitbucketのヘルプセクションをチェックして、統合の使用方法について詳しく学びましょう。 もちろん、SwaggerHubにはAPIの機能を構築するためのさまざまな統合機能が用意されているので、それらをより詳しく説明しているドキュメントを自由に参照してください。 さあ、SwaggerHubにアクセスして、この統合を試してみてください。SwaggerHubで見てみたい新しい統合があれば、機能リクエストを通じて遠慮なく提案を送信してください。 既存のSwaggerHubユーザーではありませんか？ 無料でサインアップして、SwaggerHubでより良いAPIの構築を始めましょう。