モダンな API コンシューマー エクスペリエンスがここに
刷新された開発者ポータルがパブリック ベータ版として登場

本記事は Kong Blog の記事を翻訳し転載しています。

2025 年 3 月 7 日　読了時間 4 分

Erin Choi
Kongプロダクト マーケティング

API は現代のイノベーションの原動力ですが、その価値を最大限に引き出すためには、検出しやすく、簡単に利用できるものでなければなりません。使いやすく、開発者にフレンドリーな検出レイヤーがなければ、開発者は API を探すためにバラバラのリポジトリで検索することから抜け出せなくなり、それどころか、冗長な API を構築するために時間と労力を浪費することになります。

市場はすでにこのニーズに応えてきており、API 開発者ポータルというコンセプトが登場しました。このポータルはあらゆる API の中心的なカタログとして機能しています。しかし、提供されているソリューションの多くは、デザインやブランディング、ドキュメント、API テスト、モダンな仕様レンダリングといった最新の標準に追いついていません。

本日、私たちはそれを変えることを宣言します。今回、まったく新しい Kong Konnect 開発者ポータルの最初のパブリック ベータ版をリリースしました。この新しい開発者ポータルには、新たなデザインとカスタマイズ エクスペリエンス、Kong が設計した新しい仕様レンダラー、そしてより優れた API 検索と登録エクスペリエンスが備わっています。すべての機能を詳しく見てみましょう。

無料で開発者ポータルの構築を始めてみませんか ? Konnect Plus の 30 日間の無料試用版を利用して、プロフェッショナルにブランド化されたモダンな開発者ポータルで API の活用を進めてみませんか。

モダンな開発者エクスペリエンス

あなたがそれを作れたとしても、必ずしも利用してくれるとは限りません。優れたエクスペリエンスが必要なのです。

外観、操作感、そしてレイアウトは、優れたエクスペリエンスの一部です。新しい Konnect 開発者ポータルを利用すると、API プロダクト マネージャーやプラットフォーム チームは、直感的なページ レイアウトやポータル全体の操作レベルの検索機能から、再設計されたインタラクティブで包括的な API ドキュメント エクスペリエンスに至るまで、要素全体をきめ細かく制御できるようになります。さらに詳しく見ていきましょう。

プロフェッショナルにブランド化されたポータルの詳細なカスタマイズ

素早く着手でき、最小限の時間で、機能をすべて搭載して、ブランド化されたポータルを立ち上げたいと考えるチームのために、最速で最も簡単なオンボーディング エクスペリエンスを活用できるスターター テンプレートをカスタムビルドしました。今後も、ユーザーの皆様でよく見られる一般的なユース ケースに基づいて、新たな事前構築済みの Markdown コンポーネント (MDC) を引き続き提供します。

厳格なブランディング ガイドラインに従う必要がある方のために、当社ではカスタム CSS を提供しているため、ブランドのスタイルを統合して、エクスペリエンスを高度に洗練させることができます。

厳格なブランディング ガイドラインに従う必要がある方のために、当社ではカスタム CSS を提供しているため、ブランドのスタイルを統合して、エクスペリエンスを高度に洗練させることができます。

Kong 設計の OpenAPI 3.x 仕様レンダリング （AsyncAPI のサポートも近日提供予定）

このような API リファレンス エクスペリエンスはかなり時代遅れだと感じるのは誰もが認めるところです。

当社では、既存の仕様レンダリング ツールの UX (ユーザー エクスペリエンス)と機能では不十分だと感じていたため、当社独自のものを作成しました。新しい開発者ポータル、Insomnia、Service Catalog、当社独自の Admin API ドキュメントなど、API 仕様が示される場所であればどこでも、Kong の仕様レンダラーが動作することが期待できます。また、今後数か月以内にオープンソースの Web アプリとして、より広範な開発者コミュニティにも展開していく予定です。ぜひ、ご期待ください !

ベータ版では、OpenAPI 3.x 仕様のレンダリングをサポートしています。API のプロデューサーやオーナーは、仕様ファイルをアップロードすることで、最新のAPIドキュメントを自動的に生成し、1 つまたは複数の開発者ポータル全体に公開することができます。UI に組み込まれた 「Try it」 機能により、API ユーザーはブラウザー内または Insomnia で直接機能をテストできるため、API の価値をすぐに把握し、理解することができます。つまり、より迅速に適切にAPIを導入できることになります。

当社の仕様レンダラーは、AsyncAPI をサポートして、同期プロトコルにとどまらず拡張するため、API プロデューサーは両方のタイプをシームレスに公開できるようになります。このため、API レンダリングのための統合ツールと、包括的で一元化されたドキュメントを備え、合理化されたコンシューマー DevEx (開発者エクスペリエンス) が確保できることになります。

API オーナーおよびプロデューサー向けの高度な DevEx

今回、API 公開フローを大幅に簡素化したことにより、仕様ファイルをアップロードするだけで API エンティティを作成することができます。

次に、公開する際の優先表示設定 （パブリック / プライベート） と認証設定を選択できます。API は、モダンで最新かつインタラクティブな API リファレンスとともに、適切なポータルに表示されます。

Konnect で API エンティティを作成すると、次のことが可能になります。

• API ドキュメントの追加 / 編集
• API 仕様の編集
• 1 つまたは複数のポータルへの API の公開 / 非公開、および表示設定と認証方法設定の編集(すべて1 か所で数回クリックするだけで可能)
• API エンティティを既存の Kong Gateway サービスにリンクすること （Konnect および Konnect Plus ユーザーのみ）

API オーナーは、公開する API を適切な対象ユーザーにセキュアな方法で提供することができます。セキュアな方法には、次の機能が含まれています。

• キーベース認証によるセルフサービスのアプリケーション登録と自動承認ワークフローの有効化
• ページと API の公開設定を、パブリック （ポータル リンクを知っているインターネット上の誰でも API を閲覧可能） またはプライベート （認証された開発者のみが開発者ポータルを閲覧可能） に設定
• ランディング ページと API の公開設定を制御し、パブリック （リンクを知っているインターネット上の誰でもアクセス可能） にするか、特定のページ、API へのアクセス、または API キーの取得にサインアップを要求する

API をポータルに公開した後、オーナー / プロデューサーは、Konnect 開発者ポータルに組み込まれた Analytics のダッシュボードで利用できる、主要なメトリクスを活用して、API の使いやすさとパフォーマンスを評価および強化させることができます。

新しい Konnect 開発者ポータルでどのように API を見つけて導入を実施するか、ぜひご体験ください

新しいポータルのセットアップ、API の公開、およびカスタマイズ エクスペリエンスをぜひご体験ください。
お試しいただくには、Konnect Plus にログインまたは登録し、わずか数クリックするだけで開発者ポータルを起動できます。
現在 Konnect をご利用のお客様で、開発者ポータルのご利用に興味をお持ちの場合は、Kong カスタマー サクセス マネージャーまでお問い合わせください。見つけしやすく、適切に文書化され、再利用可能な API を使って、皆さんがどのようなものを構築されるのか、楽しみにしています。

原文：The New Kong Konnect Dev Portal