組織がAPIエコノミーにさらに投資するにつれて、APIプログラムで成功を確実にするのがいかに難しいかという大きな認識が生まれています。マルチプラットフォームエコシステムに多くのデバイスが追加され、さまざまなスキルレベルの消費者がAPIを採用し始めるにつれて、プログラムが成功を収めるためにはポリシーと管理が間違いなく必要です。クラウドベースとオンプレミスベースの両方で、組織が管理レイヤーを抽象化できるプラットフォームが数多く存在します。Google の Apigee は、API管理分野の主要プレーヤーの1つとして台頭し、印象的な機能スイートと大規模で忠実な顧客ベースを誇っています。API設計とドキュメント作成プロセスをApigeeに統合するという高まる需要に応え、SwaggerHub はAPIプロキシを管理するためのプラットフォームである Apigee Edge との直接連携を発表できることを誇りに思います。
Apigee Edge へのシームレスな統合
SwaggerHub は常に、ソフトウェアライフサイクルにうまく適合する最高のコラボレーションAPI設計およびドキュメントソリューションを提供することを目指してきました。APIの設計とドキュメントは、APIの開発と消費に直接的な影響を与えます。その結果、最初の設計段階からAPIを最優先に扱うことに投資することが重要です。しかし、お客様がAPIの消費を制御および管理するために構築されたソリューションでAPIを管理する必要性も認識しており、これにはレート制限、監視、分析機能が含まれます。Apigee との直接統合は、SwaggerHub が可能な限り多くのソフトウェアライフサイクルツールと柔軟に統合できることを確実にするという当社のコミットメントをさらに強化します。これは、お客様にとって、API設計とドキュメントをプロキシとして Apigee Edge に簡単にエクスポートし、最終的に異なる開発環境と本番環境に展開および管理できることを意味します。SwaggerHub は、OpenAPI (Swagger) 仕様を使用して RESTful API を設計およびドキュメント化するチームにとって最も強力なプラットフォームです。そして、この最新の統合により、SwaggerHub はチームの API 設計とドキュメントの信頼できる唯一の情報源として機能し、Apigee の堅牢な API 管理ソリューションと同期を維持できます。このコンセプトはシンプルですが、組織の API 開発ライフサイクルに強力な影響を与えます。この統合により、API の開発と消費の間のギャップがシームレスに埋められ、お客様は SwaggerHub で両方の長所を最大限に活用できます。
仕組み
この統合は非常に使いやすいです。開始するために必要なのは次のとおりです。
- SwaggerHub Team または Enterprise アカウント
- Apigee Edge アカウント
SwaggerHub で新しい API を作成するか、既存の API にアクセスします。統合には SwaggerHub エディターの右上隅からアクセスでき、ドロップダウンから Apigee Edge 統合を選択できます。
次に、Apigee 認証を追加し、統合を設定するためにいくつかの簡単なフィールドを構成できます。フィールドは次のとおりです。
- 名前: この統合の表示名。例： Apigee。
- Apigee Edge サーバー: Edge 管理 API にアクセスするために使用される URL。Apigee Edge Cloud (SaaS バージョン) を使用している場合は、デフォルト値 https://api.enterprise.apigee.com/v1 のままにします。そうでない場合は、Edge インスタンスに対応する URL に置き換えてください。
- Apigee メール と Apigee アカウント パスワード: Apigee Edge へのログインに使用するメールアドレスとパスワード。
- 組織: API プロキシが作成される Edge アカウント内の組織。Apigee Edge のユーザー名メニューで組織名を確認できます。
- API 名: 作成される API プロキシの一意の名前。有効な文字は、英字、数字、ダッシュ (-)、アンダースコア (_) です。既存の API プロキシの名前を指定することもできます。この場合、統合によってこのプロキシの新しいリビジョンが作成されます。プロキシ名は、API 定義の x-apigee-id キーにも保存されます。
- ターゲット URL – Apigee Edge がリクエストをルーティングするエンドポイント。例： http://api.example.com/reports/v2 または https://myapi.com。API 定義で host, basePath および scheme が指定されている場合、これは scheme:host/basePath です。
以上です！統合は有効にすると、保存ごとにトリガーできます。SwaggerHub は指定された API プロキシを作成または更新し、今後 API 定義を保存するたびにプロキシの新しいリビジョンを作成します。プロキシは、既存のバックエンド API の前に管理レイヤーとして機能し、トラフィックの管理、認証の追加、ペイロードの変換など、さまざまなポリシーをアタッチできます。SwaggerHub Apigee Edge 統合の完全なドキュメントはこちらをご覧ください。
Apigee 連携を今すぐ試しましょう！
さまざまな外部ソフトウェアツールへの既存の連携ラインに Apigee 連携を導入できることを大変嬉しく思います。既存の SwaggerHub ユーザーは、今すぐログインしてご自身でお試しいただけます。現在 Apigee を API 管理に使用しているが、API 設計とドキュメント作成のために SwaggerHub をまだ検討していない場合は、14日間無料で SwaggerHub をお試しいただけます。コメント/質問/フィードバックはありますか？以下のコメントでお知らせください。