第6章 HTTP リクエスト (Webhook) によってトリガーされるインテグレーションの作成
HTTP GET または POST リクエストを Fuse Online が公開する HTTP エンドポイントに送信して、シンプルなインテグレーションの実行をトリガーできます。詳細は以下のセクションを参照してください。
6.1. Fuse Online Webhook を使用するための一般的な手順
HTTP GET または POST リクエストでインテグレーションの実行をトリガーするには、以下を行う必要があります。
-
GETまたはPOSTリクエストを Fuse Online に送信するかどうかを決定します。 - このリクエストを処理するようインテグレーションを計画します。
インテグレーションを終了するコネクションを作成します。
Fuse Online は、最初のコネクションとして使用する Webhook コネクションを提供します。
- インテグレーションに追加する他のコネクションを作成します。
インテグレーションを作成します。
- Webhook コネクションを最初のコネクションとして追加します。
最後のコネクションを追加した後、インテグレーションで必要な他のコネクションを追加します。最後のコネクションと途中のコネクションは、インテグレーションの実行をトリガーする HTTP リクエストを処理します。目的を達成するために最も適切な HTTP リクエストを選択および指定するのはユーザー自身です。これには以下を考慮してください。
- 取得または更新するデータが含まれるアプリケーションへのコネクションを追加します。
-
GETリクエストは、キー/値パラメーターの指定に限定されます。 -
POSTリクエストは、XML や JSON インスタンスなどの任意のボディーを提供します。 -
Fuse Online は HTTP ステータスヘッダーのみを返し、データは返しません。そのため、
GETリクエストによってトリガーされるインテグレーションや、データを取得せずにデータを更新するインテグレーションを定義できます。同様に、POSTリクエストによってトリガーされるインテグレーションや、データを更新せずにデータを取得するインテグレーションを定義することもできます。
Webhook コネクションの後にデータマッパーステップを追加します。
GETリクエストでは、HTTP リクエストのパラメーターフィールドを次のコネクションのデータフィールドにマップします。POSTリクエストの場合、JSON インスタンス、JSON スキーマ、XML インスタンス、または SML スキーマを渡して、リクエストに出力データシェイプを指定した可能性があります。指定しなかった場合は、Webhook コネクションをインテグレーションの最初のコネクションとして追加します。指定しないと、Webhook コネクションの出力データタイプのデフォルトは JSON 形式になります。- インテグレーションに必要な他のステップを追加します。
- インテグレーションをパブリッシュし、Running 状態になるまで待ちます。
- インテグレーション概要ページに移動し、Fuse Online が提供する外部 URL をコピーします。
-
外部 URL を編集して、
GETまたはPOSTリクエストを作成します。 -
HTTP
GETまたはPOSTリクエストを Fuse Online に送信するアプリケーションを実装します。
