ステップ 6: API を公開する

このページは ApigeeApigee ハイブリッドに適用されます。

Apigee Edge のドキュメントを表示する。

このステップでは、以下の手順で API をポータルに公開します。

  1. 仕様から API プロキシを作成する
  2. API プロダクトを作成する
  3. API をポータルに公開する

ステップ 1: 仕様から API プロキシを作成する

API を記述する OpenAPI 仕様から API プロキシを作成します。

OpenAPI 仕様から API プロキシを作成するには:

Cloud コンソールの UI

  1. Cloud コンソールの Apigee で、[プロキシ開発] > [API プロキシ] ページに移動します。

    [API プロキシ] に移動

  2. [作成] をクリックします。[Create Proxy] ウィザードが開いたら、作成する API プロキシのタイプを選択します。

  3. [Proxy template] ボックスをクリックします。

  4. [OpenAPI spec template, Reverse Proxy (most common)] をクリックします。

  5. ブラウザで次のファイルを開き、保存します。

    https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget3.0.yaml

  6. [Step 1 OpenAPI Specs] で [Browse] をクリックします。

  7. ダウンロードした OpenAPI 仕様ファイルに移動し、ファイルを選択して [Open] をクリックします。

  8. [Next] をクリックします。

  9. [Step 2 Proxy details] で、OpenAPI 仕様の値を使用してフィールドが事前入力されます。[Description] フィールドを「API proxy for hello world.」と編集します。

  10. [Next] をクリックします。

  11. [Step 3 Flows] で、すべてのオペレーションを選択します。

  12. [Next] をクリックします。

  13. [Step 4 Deploy] で、デプロイする環境を選択します。

  14. [OK] をクリックします。

  15. [Create] をクリックします。

プロキシがデプロイされると、[Deployments] セクションの [Status] 列に、API プロキシのリビジョンがデプロイされたことを示す緑色のアイコンが表示されます。このステータス アイコンにポインタを置くと、デプロイの詳細が表示されます。

従来の UI

  1. Apigee UI で、左側のナビゲーション バーから [Develop] > [API プロキシ] を選択して、[API Proxies] ページを開きます。
  2. 新規作成アイコン API プロキシの追加 をクリックします。

    [Create Proxy] ウィザードが開いたら、作成する API プロキシのタイプを選択します。

  3. [Reverse Proxy(最も一般的)] で [Use OpenAPI Spec] をクリックします。OpenAPI 仕様を使用する

    [Use OpenAPI Spec] ダイアログが表示されます。

  4. 次の URL をコピーして、[URL] タブの [OpenAPI Spec URL] に貼り付けます。

    https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget3.0.yaml
  5. [選択] をクリックします。[Create Proxy] ウィザードが開きます。[Proxy details] ページは OpenAPI 仕様の値を基にあらかじめ入力されている状態です。

    コンテンツがすでに入力された [Create Proxy] ウィザードの [Proxy details] ページ。

  6. [Description] フィールドを「API proxy for hello world.」と編集します。

  7. [Next] をクリックします。

  8. [Policies] ページで、次の操作を行います。

    • [Security: Authorization] で [Pass through (no authorization)] を選択します。
    • [Security: Browser] で、[Add CORS headers] を選択します。

    [Create Proxy] ウィザードの [Common policies] ページで、[Pass through] と [Add CORS headers] が選択されている

  9. [Next] をクリックします。

  10. [Flows] ページですべてのオペレーションが選択されていることを確認して、[Next] をクリックします。 プロキシフローの作成

  11. [Summary] ページで、[Optional Deployment] でデプロイする環境を選択します。

  12. [Create and deploy] をクリックします。

[Summary] ページに、新しい API プロキシが正常に作成され、選択した環境にデプロイされたことを示す確認応答が表示されます。

ステップ 2: API プロダクトを作成する

API コンシューマに公開する API リソースを含む API プロダクトを作成します。

API プロダクトを作成するには:

  1. Cloud コンソールの Apigee で、[配布] > [API プロダクト] ページに移動します。

    [API プロダクト] に移動

  2. [作成] をクリックします。[プロダクトの詳細] ページが表示されます。[プロダクトの詳細] に API プロダクトが入力されます。

    フィールド
    名前 Hello World
    表示名 Hello World
    説明 シンプルな Hello World の例
    環境 API プロキシがデプロイされる環境を選択します。
    アクセス Public
    接続リクエストの自動承認 有効
    割り当て (空白のまま)
    許可済みの OAuth Scopes (空白のまま)

  3. [Operations] セクションで [Add an operation] をクリックして、API プロダクトに追加するオペレーションを指定します。

    • [Source] で [API proxy] を選択し、プルダウンから [Mock-Target-API] を選択します。
    • [Operation] の [Path] フィールドに、スラッシュ(「/」)を入力します。 他のフィールドは無視します。
  4. [Save] をクリックしてオペレーションを保存します。

  5. [Save] をクリックしてプロダクトを保存します。

ステップ 3: API をポータルに公開する

API をポータルに公開して、お客様が内容を理解して使用できるようにします。

API をポータルに公開するには:

Cloud コンソールの UI

  1. Cloud コンソールの Apigee で、[配布] > [ポータル] ページに移動します。

    [ポータル] に移動

  2. [My first Portal] の行をクリックしてポータルを開きます。

  3. [APIs] タブをクリックします。

  4. [+ API] をクリックします。

  5. [API プロダクト] で [Hello World] を選択します。

  6. [Published (catalog in list)] を選択して、API をポータルに公開します。

  7. [表示のタイトル] に「Hello World」と入力します。

  8. [Display image] で [選択] をクリックします。

  9. [アセット] をクリックします。

  10. home-background.jpg の [プレビュー] をクリックします。

  11. [選択] をクリックします。

  12. [API ドキュメント] で、OpenAPI 仕様のスナップショットから API リファレンス ドキュメントを自動生成します。

    1. [OpenAPI ドキュメント] を選択します。
    2. [選択] をクリックします。
    3. [URL] タブをクリックします。
    4. [Spec name] フィールドに「helloworld」と入力します。
    5. 次の URL をコピーして [URL] フィールドに貼り付けます。
      https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget3.0.yaml
    6. [選択] をクリックします。
  13. [保存] をクリックします。

従来の UI

  1. Apigee UI で、ポータルの API ページに移動します。
    1. 左側のナビゲーション バーで [公開] > [ポータル] を選択します。
    2. [My first Portal] の行をクリックしてポータルを開きます。
    3. [API Catalog] をクリックして API ページを表示します。
  2. [+] をクリックします。
  3. [Add an API product to the catalog] ダイアログで [Hello World] を選択し、[Next] をクリックします。
  4. [API の詳細] で、次のオプションを構成します。
    • [Published (catalog in list)] を選択して、API をポータルに公開します。
    • [Display image] の場合:
      1. [Select image] をクリックします。
      2. [Select image] ダイアログで、既存のイメージのリストから [home-background.jpg] をクリックします。
      3. [Select] をクリックします。
      4. 画像をプレビューし、[Select] をクリックします。
    • [カテゴリ] に「Get Started」と入力して、Enter キーを押します。

    その他の値はすべてデフォルトのままにします。

    API をポータルに追加する際の API の詳細セクション

  5. [API ドキュメント] で、OpenAPI 仕様のスナップショットから API リファレンス ドキュメントを自動生成します。
    1. [OpenAPI ドキュメント] を選択します。
    2. [Select Document] をクリックします。
    3. [Import from a URL] タブを選択します。
    4. [Spec name] フィールドに「helloworld」と入力します。
    5. 次の URL をコピーして [URL] フィールドに貼り付け、Enter キーを押します。
      https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget3.0.yaml
    6. [Select] をクリックします。

    API をポータルに追加する際の API ドキュメントのセクション

  6. [保存] をクリックします。

ステップ 4: API リファレンス ドキュメントを表示する

API リファレンス ドキュメントを表示するには:

  1. Apigee UI で [Live Portal] をクリックして、ライブポータルで変更を表示します(または、ライブポータルがすでに別のタブで開いている場合は更新します)。
  2. ライブポータルで次の操作を行います。
    1. 上部のナビゲーション バーにある [APIs] をクリックして、公開された API を表示します。 b.
    2. [Hello World] カードをクリックして、API リファレンス ドキュメントを表示します。
    3. API を試してみましょう。

[この API を試す] パネルを使用して公開した Mock Target API