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 ゲートウェイとの統合を通じて安全にアクセスを提供できます。