このページは Apigee と Apigee ハイブリッドに適用されます。
Apigee API Hub を使用すると、組織に関連するすべての API に関する情報を統合して一元管理できます。デベロッパーは、API Hub で収集された API に関する重要な情報を使用して API を簡単に探索および評価し、他のチームの作業を可能な限り利用できます。API プラットフォーム チームは、API Hub を使用して API ポートフォリオの可視化や管理を行うことができます。
一元化された API 管理の価値
多くの組織は、作成および使用する API の数が増えることに課題を抱えています。API の数が増えると追跡が難しくなり、結果として再利用ではなく重複が発生し、コスト効率が低下します。設計基準やガバナンス チェックなしで API が広がっていくと、API 環境の一貫性が損なわれ、チームの生産性は低下します。それに対して、適切に編成された API プログラムがあれば、作業時間の短縮につながります。
API Hub の使用環境は、組織のネットワーク エコシステムの内外で API を探して一覧表示、比較、評価することが大きな懸案事項になっている組織の API のコンシューマーとプロデューサーを主な対象としています。API Hub では、すべての API を含む完全なカタログと、API バージョン、依存関係、デプロイなどの関連するエンティティを管理できます。API 仕様を API バージョンに関連付けることもできます。OpenAPI 仕様の場合、仕様が自動的に解析されて API オペレーションなどのメタデータが抽出されます。また、API バージョンを特定の API デプロイ エンドポイントにリンクすることもできます。
Apigee API Hub の主なメリット
API Hub 管理者は、以下のことができます。
- すべての API と関連するエンティティを含む完全なカタログを追加、編集、管理する。
- API のバージョニングのサポート、バージョンと API 仕様のリンク、仕様から解析されたオペレーションの表示、API バージョンと特定のデプロイ エンドポイントのリンクなどを使用して、API ライフサイクル全体を管理する。
- API の集合に属性を追加し、さまざまなライフサイクル ステージ、コンプライアンス情報、その他の追跡したい情報で API にタグ付けする。
- 豊富な属性に基づいて API をフィルタおよび検索する。
- API Hub を 1 つ以上の Apigee プロジェクトと Apigee ハイブリッド プロジェクトにリンクして、Apigee API プロキシ情報を自動的に取得し、API Hub に保存する。API Hub は、スケジューラを定期的（6 時間ごと）に実行して Apigee プロジェクトに接続し、最新のプロキシ定義を取得します。
- 強力なセマンティック検索機能を使用し、自由形式の検索で API を探す。
- lint チェック機能を使用して API 仕様ファイルの準拠状況を追跡する。
- API のさまざまなオペレーション間の依存関係をモデル化することで、API の依存関係を追跡する。
- API のライフサイクル データを保存する。
API Hub を使用して API に関する豊富な情報を 1 か所に集約すれば、API ポートフォリオの一貫性、使用、再利用、ガバナンスが促進されます。
主な機能とコンセプト
API リソース
API リソースは、組織のネットワーク エコシステム内に存在する API を表します。API Hub に保存されている API リソースは検索可能で、API に関する詳細な運用情報と説明情報（デプロイ、バージョン、オペレーション、ライフサイクル ステージ、その他の主要な属性など）を提供します。
バージョニング
API バージョンをモデル化して整理する機能は、API Hub の重要な機能です。API Hub では、すべての API リソースに少なくとも 1 つのバージョンが関連付けられています。バージョンは、ある時点での API の状態と考えることができます。基本的に、バージョンは、基になるオペレーション、デプロイ、その他のメタデータの組み合わせに基づいて API を分類・整理するのに役立ちます。
Apigee API プロキシの自動登録
自動登録とは、外部システムから API データを取得して API Hub に取り込むことを意味します。ランタイム プロジェクトを API Hub にアタッチすることで、Apigee または Apigee ハイブリッド ランタイム プロジェクトに存在するすべてのプロキシを API Hub に直接登録できます。Apigee プロキシの自動登録をご覧ください。
仕様の解析と lint チェック
API Hub のもう一つの重要な機能は、OpenAPI 仕様などの特定の API 仕様を解析し、それらの仕様内の定義、オペレーション、その他の主要なコンポーネントを API リソースとともに保存する機能です。API Hub は、インポートされた仕様に関する lint チェック フィードバックも提供します。
検索
API Hub の強力な検索機能は、LLM ベースのフリーテキスト検索とフィルタベースの検索の両方をサポートしています。これにより、API 定義の任意の部分に基づいて検索を行うことができます。これらの強力な検索ツールを使用すると、特定のユースケースに対応する API アセットを特定し、API エンジニアリングの再構築や重複を回避できます。
依存関係のマッピング
API Hub の依存関係は、API 間のサプライチェーンの関係を表示して管理するのに役立ちます。API の依存関係を検出および追跡することで、API エコシステムをより効率的に管理し、機能しなくなった API オペレーションのトラブルシューティングを行うことができます。