第7章 HTTP リクエスト (Webhook) によってトリガーされるインテグレーションの作成

HTTP GET または POST リクエストを Fuse Online が公開する HTTP エンドポイントに送信して、シンプルなインテグレーションの実行をトリガーできます。詳細は以下のセクションを参照してください。

7.1. Fuse Online Webhook を使用するための一般的な手順

HTTP GET または POST リクエストでインテグレーションの実行をトリガーするには、以下を行う必要があります。

  1. GET または POST リクエストを Fuse Online に送信するかどうかを決定します。
  2. このリクエストを処理するようインテグレーションを計画します。

  3. インテグレーションを終了するコネクションを作成します。

    Fuse Online は、最初のコネクションとして使用する Webhook コネクションを提供します。

  4. インテグレーションに追加する他のコネクションを作成します。

  5. インテグレーションを作成します。

    1. Webhook コネクションを最初のコネクションとして追加します。

    2. 最後のコネクションを追加した後、インテグレーションで必要な他のコネクションを追加します。最後のコネクションと途中のコネクションは、インテグレーションの実行をトリガーする HTTP リクエストを処理します。目的を達成するために最も適切な HTTP リクエストを選択および指定するのはユーザー自身です。これには以下を考慮してください。

      • 取得または更新するデータが含まれるアプリケーションへのコネクションを追加します。
      • GET リクエストは、キー/値パラメーターの指定に限定されます。
      • POST リクエストは、XML や JSON インスタンスなどの任意のボディーを提供します。
      • Fuse Online は HTTP ステータスヘッダーのみを返し、データは返しません。そのため、GET リクエストによってトリガーされるインテグレーションや、データを取得せずにデータを更新するインテグレーションを定義できます。同様に、POST リクエストによってトリガーされるインテグレーションや、データを更新せずにデータを取得するインテグレーションを定義することもできます。

    3. Webhook コネクションの後にデータマッパーステップを追加します。

      GET リクエストでは、HTTP リクエストのパラメーターフィールドを次のコネクションのデータフィールドにマップします。

      POST リクエストの場合、JSON インスタンス、JSON スキーマ、XML インスタンス、または SML スキーマを渡して、リクエストに出力データシェイプを指定した可能性があります。指定しなかった場合は、Webhook コネクションをインテグレーションの最初のコネクションとして追加します。指定しないと、Webhook コネクションの出力データタイプのデフォルトは JSON 形式になります。

    4. インテグレーションに必要な他のステップを追加します。
  6. インテグレーションをパブリッシュし、Running 状態になるまで待ちます。
  7. インテグレーション概要ページに移動し、Fuse Online が提供する外部 URL をコピーします。
  8. 外部 URL を編集して、GET または POST リクエストを作成します。
  9. HTTP GET または POST リクエストを Fuse Online に送信するアプリケーションを実装します。