SwaggerHub の評価版は、14日間有効です。
高品質の API が実現するだけではありません。 それらは、ビジネス ゴールに合わせた一貫した設計標準から始まります。 SwaggerHub を使用すると、品質とスタイルの一貫性を確保しながら、チームの設計プロセスを加速できます。 API エディターは、Swagger (現在 OpenAPI 仕様 (OAS) と呼ばれる) に準拠しており、シンプルで直感的です。
チームの API 設計ワークフローを次の方法でアップグレードします。
コミュニケーションの欠如ほど、開発サイクルを遅くするものはありません。 SwaggerHub は、複数のチームにわたる API コラボレーションと標準化を促進するように設計されました。 SwaggerHub を API 定義の唯一の信頼できる情報源として活用することで、高品質の API をより迅速に市場に提供できます。
以下のコラボレーションを明確にします。
API イニシアチブを成功させるには、正確で最新のドキュメントが不可欠です。 SwaggerHub を使用すると、設計中にインタラクティブなドキュメントを自動的に生成できるため、API コンシューマーと内部ユーザーの両方が API を簡単に学習して操作できます。
次の方法で API ドキュメントへのアプローチを強化します。
RealPage のチームがどのように SwaggerHub Enterprise を使用して、配信までの時間を短縮し、チーム間で共通の方法でコミュニケーションするかをご覧ください。
API ワークフローを合理化し、素晴らしい API をこれまでよりも速く提供したいチーム向け。
オンプレミスまたはクラウドで利用可能な安全な環境で複数のチームにわたって作業する必要がある組織向け。
SwaggerHub は、API 開発ワークフロー全体で一貫性と規律を推進するためにチーム向けに構築された、統合された API 設計およびドキュメンテーション プラットフォームです。
SwaggerHub は、チームの API 設計ワークフローをサポートする機能を提供します。
スピードと効率性のために構築された強力な API エディターで API を設計します。
最新の Swagger (OpenAPI) 標準に完全に準拠した強力なエディターにより、品質や組織スタイルの一貫性を損なうことなくチームの設計プロセスを加速します。
Swagger/OpenAPI コントラクトの迅速な反復のために構築された直感的なブラウザーベースのエディターで、新規および既存の API を設計します。 コンシューマーの採用を最大化する API を設計するための手間のかからない編集エクスペリエンスにより、その場で設計を検証して保存します。
組み込みの API 標準化を使用して、すべての API が組織の設計標準に準拠していることを保証します。 API 全体でスタイルの一貫性を維持するために開発者が参照する必要がある wiki ページ、GitHub ドキュメント、PDF はもう必要ありません。
API を定義するときに、すべての繰り返しパスと応答を継続的に書き換える必要をなくします。 SwaggerHub では、組織の一般的なスタイルを再利用可能なコンポーネントとして保存し、すべての API で再利用できます。
制御されたアクセスと開発者に優しいワークフローにより、API を一元的に維持およびコラボレーション
API の設計と開発を 1 か所に集中化して、チームが新しい API でシームレスに共同作業したり、集中化したプラットフォームで既存の API を発見したりできるようにします。
SwaggerHub は組織向けに構築されており、API 契約、ドキュメント、チームを一元管理できます。 セキュリティやスケーリングを心配することなく、API の設計と構築に協力するチームを設定します。
SwaggerHub コメントを使用して、新しいアイデアについて慎重に検討し、問題をハイライトし、それらを一緒に解決します。 SwaggerHub のコメントは発券システムとしても機能します。つまり、未解決の問題や会話を常に追跡し、それに応じて解決して優先順位を付けることができます。
複数の開発プラットフォームにまたがるさまざまなチーム メンバーからの更新を追跡するという頭痛の種を取り除きます。 開発者に必要な独立性を与え、設計者は変更を追跡し、更新が行われたときに通知を受けるために必要な監視を行います。
GitHub、GitLab、Bitbucket などのソース管理ホスト間でのシームレスな同期から、AWS、Azure、IBM などの APIM プラットフォームへの API デプロイメント、カスタム Webhook を使用した外部ビルド トリガーまで、SwaggerHub は組織が API 開発を次のレベルに引き上げるように設計されています。
API をホストし、優れた API を提供するためにチームが信頼するツールに統合するための内部リポジトリー
クラウドでホストされている中央の内部リポジトリから API ライフサイクル全体を調整します。
SwaggerHub は、API 定義をホストおよび発見するための真の情報源として機能します。 内部リポジトリで API 定義をホストし、チーム、プロジェクト、またはその他のアーキテクチャ上の考慮事項に基づいて API を整理します。
RESTful サービスへの変更は不可避であり、既存の API のバージョン管理を容易にすることは、エラーが発生しやすいプロセスになる可能性があります。 SwaggerHub を使用すると、API の新しいバージョンを継続的に更新および公開できるため、ユーザーは適切なバージョンに適切なタイミングでアクセスできます。
API が進化して変更が加えられると、利害関係者の調整を保つことが重要です。 SwaggerHub は、API アーキテクトとチームに、変更の追跡、問題の解決、API の内部開発方法の標準化に必要な監視を提供します。
設計とドキュメントは、より大きな API ライフサイクルの一部にすぎません。SwaggerHub はそれらに特化していますが、チームが他の外部ソフトウェア ソリューションとシームレスに連携できるようにします。 API ゲートウェイにデプロイする場合でも、サーバー側のコードリポジトリと同期する場合でも、テストツールに接続する場合でも、SwaggerHubは 既存のワークフローにうまく適合します。
安全にホストされ、完全にインタラクティブな API ドキュメントを自動的に生成
インタラクティブで完全にホストされ、プライバシーが有効な美しいドキュメントを生成し、手動のインフラストラクチャの複雑さを完全に排除します。
SwaggerHub は、実際の API コントラクトを視覚的にレンダリングし、ライブ ワークアビリティの完全なインタラクティブ ドキュメントとして提供します。これにより、エンド コンシューマーは、コードに統合する前に、API がどのように動作し、動作するかを正確に知ることができます。
SwaggerHub で OAS を使用して API の文書化をすぐに始めたいですか? 統合された Swagger Inspector を利用すると、既存の API から OAS ドキュメントを生成できます。 3 ステップ以下で、OAS 定義が生成され、SwaggerHub でホストされます。
API の既存の OAS 定義がありますか? Web またはローカル ファイル システムから追加のドキュメントを取得するために、既存の OAS ベースの API をインポートできます。 API 定義とそのドキュメントは、インポート時にクラウドに完全にインポートされるため、チームは API にリッチコンテンツとリソースを追加できます。
API ドキュメントは、API コンシューマーがドキュメントにアクセスし、API の操作に必要な情報を取得できる場合にのみ役立ちます。 SwaggerHub を使用すると、API ドキュメントをクラウドでホストし、組み込みの権限制御と API ゲートウェイとの統合を通じて安全にアクセスを提供できます。
SwaggerHub Enterprise プランは、Swagger を使用したコラボレーティブ API 開発を拡張したいビジネス向けに構築されています。 SwaggerHub Enterprise は、クラウドとオンプレミスの両方のインストールで使用できます。
ファイアウォールの背後にオンプレミスをインストール | |
制限なしの API 設計のスケーリング | |
API スタイルのガイドラインを適用する | |
シングル サインオン (SSO) のサポート | |
オンプレミス ソリューションとの統合 | |
チーム管理とガバナンスを改善 |
すべての API を 1 つの集中型プラットフォームで安全にホストし、すべてのチームと組織のメンバーが作業できるようにします。 組織のニーズに基づいて適切な人と API に適切なアクセスとプライバシーを提供し、複数のステークホルダー(利害関係者) とコンシューマーにわたって何百もの API を効果的に管理します。
組織の API 全体で設計の一貫性を確保することは、API チームにとって頭痛の種になる可能性があります。 SwaggerHub Enterprise を使用すると、速度と開発時間を失うことなく、設計の一貫性を維持できます。 組織の一般的なスタイルとモデルをドメインに保存して、何百もの API プロジェクトで参照したり、Style Validator を使用して個々の API のスタイルの整合性をチェックしたりできます。
SwaggerHub は、ファイアウォールの背後に SwaggerHub をインストールする機能を提供し、追加のカスタマイズと内部ツールとの統合を備えています。 SwaggerHub On-Premise を使用すると、セキュアなオンプレミス インストール、SAML を使用した SSO、LDAP および GitHub Enterprise、およびカスタマイズされた統合により、エンタープライズ プランのすべてのサポートを利用できます。
オンボーディングとセットアップのプロセス全体を支援する専任のアカウントマネージャーがいます。 パーソナライズされたトレーニングをスケジュールし、必要なときに質問の回答が得られます。
SwaggerHub の評価版を取得するには、以下のボタンをクリックして、手続きを行ってください。
Swagger Inspector は、既存の API の OAS 定義を生成する最も速くて簡単な方法です。 数回クリックするだけで、OpenAPI 定義を生成し、それを SwaggerHub でホストできます。
チームが API のデプロイと管理に使用するゲートウェイに SwaggerHub を接続し、SwaggerHub で API 設計を進化させ続けます。 統合により、API 設計とドキュメント間での展開と管理へのシームレスな移行が可能になります。 AWS、Microsoft Azure、IBM API Connect、Apigee などの主要な API 管理プラットフォームから選択できます。
SwaggerHub を利用してサーバー テンプレートとクライアント SDK を生成している場合は、API 定義をGitHub、Bitbucket、GitLab、Azure DevOps Services、Azure DevOps Server のソース管理リポジトリと同期することもできます。 同期は、SwaggerHub で API を保存するたびに行われます。 ターゲット リポジトリで追加、更新、または無視するファイルを完全に制御できます。
API 定義は、QA チームが API の機能をテストするためのテストケースを簡単に生成するためのコントラクトを提供します。 SmartBear の機能テストプラットフォームである SoapUI のユーザーは、API 定義をインポートして、機能テストをすばやく生成して実行できます。
Webhook を使用すると、ライフサイクル中に独自のサービスと統合をトリガーできます。 ビルドのトリガー、ユニット テスト、開発者へのメール送信のいずれであっても、SwaggerHub Webhook を使用して自動化シナリオを思い描くことができます。
SwaggerHub の評価版を取得するには、以下のボタンをクリックして、手続きを行ってください。
大規模あるいは小規模なソフトウェアチームの進化するニーズに対応するために SwaggerHub は作成され、安全で統合されたプラットフォームを提供します:
オープンソースの Swagger | SmartBear SwaggerHub |
|
---|---|---|
設計 | 基本的なスタイルのバリデーションを行う YAML エディター | API 定義のためにあらかじめデザインされたテンプレート、同時のスタイル フィードバック、モック、ホスティングを備えたクラウドベースの YAML エディター |
開発 | Swagger CodeGen によるコード生成 | GitHub、Bitbucket、GitLab などのソース管理ホストと自動的に同期できる 20以上のサーバー言語でのコード生成 |
ドキュメント | インタラクティブな API ドキュメントと SwaggerUI を使用したサンドボックス | インタラクティブな API ドキュメントとサンドボックス、およびクライアント SDK 用の自動生成、すべてがプライバシー制御でクラウドでホストされています。 |
モック | モック機能はありません | コードを書くことなく操作を仮想化するための API のモックを生成 |
ホスト | ホスティング機能はありません | Swagger 定義と API ドキュメントのための、アクセス制御機能を内蔵した安全なクラウドベースのホスティング |
コラボレート | コラボレーション機能はありません | リアルタイムの問題追跡と会話、チーム管理、役割の割り当て、およびアクセス許可/アクセス制御 |
デプロイ | デプロイメント機能はありません | AWS、Microsoft Azure、IBM API Connect などの API ゲートウェイに API 定義をすばやくデプロイできます。 サーバーレス デプロイ用のAWS Lambda 関数を自動的に生成します。 |
バージョン管理 | バージョン管理機能はありません | API 定義の複数のバージョンを管理し、古くなった API を廃止 |
◎ 高度な設計機能を備えたクラウドベースのエディター
スタイルの検証を組み込んだクラウドベースのエディターで Swagger 定義を作成して編集して、エラーを減らしたり、API をどのように動作させるかをプレビューしたり、コードを書くことなく設計上の意思決定を検証することができる自動モック機能を利用できます。
◎ 統合ドキュメント ワークフロー
Swagger 定義を記述し、ドキュメントを操作し、他のツールを必要とせずに、直感的なインターフェイスでコードとクライアント SDK を生成します。 SwaggerHub はすべてを同期し、ソース管理と API 管理プラットフォームとシームレスに統合します。
◎ セキュアなクラウドホスティング
すべての API 定義と関連ドキュメントを API 用に構築されたプラットフォームに格納します。 SwaggerHub は設計プロセス全体を通して作業を自動保存し、サーバーを設定することなくドキュメントをホストする中心的な場所を提供します。
◎ プライバシーとアクセス コントロール
SwaggerHub のビルトインのプライバシーコントロールを使用して、API にアクセスできるユーザーを制御し、機密情報を保護します。 新しい API を設計する場合や、既存の Swagger 定義をドキュメント化する場合は、アクセス コントロールを使用してください。
◎ バージョン管理とパブリッシング
SwaggerHub は、API の複数のバージョンを管理する機能を備え、継続的に更新と反復処理を行います。 新しいバージョンでは、最後の更新されたバージョンから既存の構文をコピーするので、最初からビルドを開始する必要はありません。
◎ コラボレーション & チーム管理
SwaggerHub は、チームが API の設計とドキュメント全体で協力するための中心的なプラットフォームを提供します。 SwaggerHub エディターのコメントで、API を社内外の投稿者と安全に共有し、問題をリアルタイムで追跡します。 SwaggerHub は、定義が変更されたときに自動的に共同編集者に通知します。
◎ ソース管理と API 管理プラットフォームとの同期
中心的なプラットフォームから API のライフサイクル全体を管理します。API のさまざまなバージョンをソース管理ツールや API 管理プラットフォームと同期させることで、Swagger 定義を更新し、ドキュメント、サーバーコード、およびデプロイメントを自動的に更新できます。
◎ 共通モデルの再利用
すべての共通コンポーネントをドメインに保存します。これをすべての API から参照して、作業を標準化して時間と労力を節約できます。
SwaggerHub に関する 「FAQ - よくある質問とその回答」ページをご用意しております。
SwaggerHub ドキュメント: https://app.swaggerhub.com/help/index
SwaggerHub オンプレミス リリースノート: https://app.swaggerhub.com/help/enterprise/release-notes
SwaggerHub Saas - 変更履歴:
https://app.swaggerhub.com/changelog
SwaggerHub アカウントの作成方法: https://app.swaggerhub.com/help/signup
アカウント管理: https://app.swaggerhub.com/help/account/index
SwaggerHub チュートリアル:
https://app.swaggerhub.com/help/tutorials/index
注意: 上記のオンライン ドキュメントは英語での提供となります。
※ Google Chrome で開き、Google 翻訳を選択するか、ページを右クリックし、コンテキストメニューの「日本語に翻訳(T)」 機能をご使用いただくと、機械翻訳された内容でご覧いただけます。 Microsoft Edge で開いて、Translator For Microsoft Edge でも機械翻訳でご覧いただけます。
機械翻訳された日本語ドキュメント