4.3. REST API コネクターの作成

手順

1. todo app のアイコンをダウンロードします。

   1. Fuse Online ナビゲーションパネルで Home をクリックします。
   2. URL をテキストエディターにコピーします。
   3. URL の先頭に、todo- を挿入します。
   4. URL の末尾に /images/todo_icon.png を追加します。

   5. https の代わりに http スキームを使用します。

      URL は http://todo-app-proj217402.6a63.fuse-ignite.openshiftapps.com/images/todo_icon.png のようになります。

   6. この URL を新しいブラウザーウインドウに貼り付け、ファイルシステムの場所に todo_icon.png ファイルをダウンロードします。このアイコンを手順 11 でアップロードします。

2. Fuse Online 環境にある OpenAPI ドキュメントのコピーの URL を確認します。

   1. Fuse Online ナビゲーションパネルで Home をクリックします。
   2. URL をテキストエディターにコピーします。
   3. URL の先頭に、todo- を挿入します。
   4. URL の最後に swagger.json を追加します。

   5. https の代わりに http スキームを使用します。

      URL は http://todo-app-proj217402.6a63.fuse-ignite.openshiftapps.com/swagger.json のようになります。

   注記

   https ではなく http を指定することで、TLS 証明書が有効でない場合にランタイムエラーが発生しないようにします。実稼働環境では、有効な証明書があり、常にセキュアな URL (https) を指定して OpenAPI ドキュメントを取得するようにします。

3. Fuse Online ナビゲーションパネルで Customizations > API Client Connectors をクリックします。
4. Create API Connector をクリックします。
5. Use a URL を選択します。
6. 入力ボックスに OpenAPI ドキュメントの URL を貼り付け、Next をクリックします。
7. Review Actions ページで Next をクリックします。警告が表示された場合、無視しても問題ありません。
8. Next をクリックします。
9. Specify Security ページで、HTTP Basic Authentication を許可し、admin および admin などのユーザー名とパスワードを指定します。このサンプルアプリケーションでは、ユーザー名とパスワードは検証されないことに注意してください。
10. Next をクリックします。

11. Todo App API 概要ページで以下を行います。

    1. Connector Icon で Choose File をクリックし、手順 1 でダウンロードした todo_icon.png の場所に移動します。
    2. 必要に応じて、Name フィールドおよび Description フィールドの値を変更します。
    3. Host フィールドに、サービスホストの名前を承認します。たとえば、https://todo-app-proj217402.6a63.fuse-ignite.openshiftapps.com のようになります。
    4. Base URL フィールドに、サービスリクエストのホスト名の後に続く URL の一部 (/api) を受け入れます。

12. Save をクリックします。

    Fuse Online に API Client Connectors が表示されます。先ほど作成した Todo App API で新しいエントリーを確認できます。