4.3. REST API コネクターの作成
Fuse Online は、Hypertext Transfer Protocol (HTTP)/1.0 または HTTP/1.1 をサポートする REST API のコネクターを作成できます。これには、接続する REST API を記述する有効な OpenAPI 3 (または 2) ドキュメントが Fuse Online に必要です。
Fuse Online 環境には To Do アプリケーションがあり、これにはタスクが含まれるデータベースにアクセスするための REST API があります。お使いの環境には、この API の OpenAPI ドキュメントもあります。
手順
todo app
のアイコンをダウンロードします。- Fuse Online ナビゲーションパネルで Home をクリックします。
- URL をテキストエディターにコピーします。
-
URL の先頭に、
todo-
を挿入します。 -
URL の末尾に
/images/todo_icon.png
を追加します。 https
の代わりにhttp
スキームを使用します。URL は http://todo-app-proj217402.6a63.fuse-ignite.openshiftapps.com/images/todo_icon.png のようになります。
-
この URL を新しいブラウザーウインドウに貼り付け、ファイルシステムの場所に
todo_icon.png
ファイルをダウンロードします。このアイコンを手順 11 でアップロードします。
Fuse Online 環境にある OpenAPI ドキュメントのコピーの URL を確認します。
- Fuse Online ナビゲーションパネルで Home をクリックします。
- URL をテキストエディターにコピーします。
-
URL の先頭に、
todo-
を挿入します。 -
URL の最後に
openapi.json
を追加します。 https
の代わりにhttp
スキームを使用します。URL は
http://todo-app-proj217402.6a63.fuse-ignite.openshiftapps.com/openapi.json
のようになります。
注記https
ではなくhttp
を指定することで、TLS 証明書が有効でない場合にランタイムエラーが発生しないようにします。実稼働環境では、有効な証明書があり、常にセキュアな URL (https
) を指定して OpenAPI ドキュメントを取得するようにします。- Fuse Online ナビゲーションパネルで Customizations > API Client Connectors をクリックします。
- Create API Connector をクリックします。
- Use a URL を選択します。
- 入力ボックスに OpenAPI ドキュメントの URL を貼り付け、Next をクリックします。
- Review Actions ページで Next をクリックします。警告が表示された場合、無視しても問題ありません。
- Next をクリックします。
-
Specify Security ページで、HTTP Basic Authentication を許可し、
admin
およびadmin
などのユーザー名とパスワードを指定します。このサンプルアプリケーションでは、ユーザー名とパスワードは検証されないことに注意してください。 - Next をクリックします。
Todo App API 概要ページで以下を行います。
-
Connector Icon で Choose File をクリックし、手順 1 でダウンロードした
todo_icon.png
の場所に移動します。 - 必要に応じて、Name フィールドおよび Description フィールドの値を変更します。
Host フィールドで、サービスホストの名前を受け入れます。たとえば、
http://todo-app-proj217402.6a63.fuse-ignite.openshiftapps.com
のようになります。必要に応じて
\https:
を\http に変更します
。-
Base URL フィールドに、サービスリクエストのホスト名の後に続く URL の一部 (
/api
) を受け入れます。
-
Connector Icon で Choose File をクリックし、手順 1 でダウンロードした
Save をクリックします。
Fuse Online に API Client Connectors が表示されます。先ほど作成した Todo App API で新しいエントリーを確認できます。