HTTPリクエストを送信する

「HTTPリクエストを送信する」アクションは、ワークフローをウェブサーバーまたはURLに接続し、HTTPリクエストを送信します。

FlowがHTTPリクエストを送信すると、最大30秒間、HTTPレスポンスコードを待機します。30秒経ってもFlowが応答を受信しない場合、アプリへの接続を閉じて、後でリクエストを再試行します。

フィールド

「HTTPリクエストを送信する」アクションには、次のフィールドが含まれています。

返されるデータ

このアクションに続くステップで返されたデータにアクセスするには、sendHttpRequestという名前の変数を使用します。この変数には、HTTP応答のすべての詳細が含まれています。オプションで、以下の例のように、「コードを実行する」アクションを使用して応答のbodyを解析し、後続のワークフローステップで使用することもできます。

1 つのワークフローでHTTPリクエストを送信アクションが複数回使用される場合、変数名に数字が追加されます。たとえば、HTTPリクエストを送信アクションを 2 回使用するワークフローでは、返されたデータの最初の変数は sendHttpRequest で、2 番目の変数は sendHttpRequest1 になります。この名前はカスタマイズできません。

レスポンスコード

次の表では、Flowが応答を受信した後にHTTPレスポンスコードをどのように処理するかについて説明します。

シークレット

シークレットは、アクセストークンやパスワードなど、HTTPリクエストを送信アクションで使用する機密情報を安全に保存するために使用されます。シークレットは、Flow > 設定 ページから作成および管理されます。シークレットには、ハンドル、値、説明が含まれます。シークレットは、Liquid変数 ({{secrets.handle}} など) として参照するか、URL、ヘッダー値、本文フィールドを設定する際にシークレットを追加オプションから参照します。シークレットの値が Flow のインターフェイスに表示されることはなく、ワークフローの実行ログからも秘匿化されます。

トリガー

「HTTPリクエストを送信する」アクションは、どのワークフローでも使用できます。

例

例1：外部サービスにHTTPリクエストを送信する

この例では、Flowを使用して外部サービスにHTTPリクエストを送信します。

始める前に、テスト用にHTTPリクエストを受信してそのリクエストのデータを保存するウェブサービス (たとえばRequest Catcherなど) を設定します。パスワードやAPIキーなどの機密データを外部サービスに送信する際は、注意が必要です。

手順：

1. 商品のステータスが更新されましたトリガーを選択します。これにより、商品のステータスを変更してこのワークフローをテストできます。
2. ワークフローに 「HTTPリクエストを送信する」 アクションを追加してトリガーに接続します。次に、 「HTTPリクエストを送信する」 ステップをクリックして設定パネルを開きます。
   • [HTTPメソッド] フィールドに、POST と入力します。
   • [URL] フィールドに、https://yourFlowTest.requestcatcher.com/test のように、テスト対象の URL を入力します。
   • [ヘッダー] セクションで、[キー] を Content-Type、[値] を text/plain としてヘッダーを入力します。
   • [本文] セクションで、トリガーから商品のタイトルと更新されたステータスを送信するために、{{product.title}} と {{product.status}} を入力します。
3. ワークフローを有効化します。
4. 商品のステータスを下書きから有効に変更するなどして、テストします。
5. この例では https://yourFlowTest.requestcatcher.com/ のような外部テストサービスで結果を確認します。

例2：コードを実行を使用して HTTP 応答を解析する

この例では、Flow を使用して外部サービスに HTTP リクエストを送信し、コードを実行アクションを使用して HTTP 応答の body を解析し、後続のワークフローステップで使用します。

開始する前に、Postman Echo のように、HTTP リクエストを受信してデータを返すウェブサービスを選択してください。パスワードや API キーなどの機密データを外部サービスに送信する際は、注意が必要です。

手順：

1. 商品のステータスが更新されましたトリガーを選択します。これにより、商品のステータスを変更してこのワークフローをテストできます。

2. ワークフローに「HTTPリクエストを送信する」アクションを追加し、トリガーに接続します。次に、「HTTPリクエストを送信する」ステップをクリックして設定パネルを開きます。

   • [HTTPメソッド] フィールドに、POST と入力します。

   • [URL] フィールドに、https://postman-echo.com/post のように、テスト対象の URL を入力します。

   • [ヘッダー] セクションで、[キー] を Content-Type、[値] を application/json としてヘッダーを入力します。

   • [本文] セクションに、次のように、ワークフローに返す JSON の例を入力します。

     {
         "productTitle": "{{product.title}}",
         "productStatus": "{{product.status}}"
     }

3. ワークフローに「コードを実行」アクションを追加し、「HTTPリクエストを送信する」アクションに接続します。次に、「コードを実行」ステップをクリックして設定パネルを開きます。

   • [入力を定義] フィールドに、次のように、sendHTTPrequest オブジェクトによって返される body を含めます。

     query{
       sendHttpRequest {
         body
       }
     }

   • [出力を定義] フィールドで、次のように、出力スキーマを定義します。

     type Output {
       productTitle: String!
       productStatus: String!
     }

   • [コードを記述] フィールドで、JSON.parse メソッドを使用して応答を解析し、返すデータが出力スキーマで定義した形と型に一致することを確認します。たとえば、次のようになります。

     export default function main(input) {
       const body = JSON.parse(input.sendHttpRequest.body);
       console.log("body is", body);
       return {
         productTitle: body.data.productTitle,
         productStatus: body.data.productStatus
       }
     }

4. ワークフローに「ログ出力」アクションを追加し、「コードを実行」アクションに接続します。次に、「コードを実行」ステップをクリックして設定パネルを開きます。

   • [出力] フィールドに、次のように、「コードを実行」ステップによって返される変数を含めます。

     Title from HTTP response: {{runCode.productTitle}}
     Status from HTTP response: {{runCode.productStatus}}

5. ワークフローを有効化します。

6. 商品のステータスを下書きから有効に変更するなどして、テストします。

7. Flow / 最近の実行ページで実行結果を確認し、「ログ出力」ステップの値が「HTTPリクエストを送信する」の出力から返された値と一致することを確認します。

テンプレート

フルフィルメントプロバイダーに次回の注文について通知する

Order Tagger で注文に「Warehouse」のタグが付けられたときに、フルフィルメントプロバイダーに HTTP リクエストを送信します。テンプレートを表示する

新しい注文を Airtable に送信する

注文が作成されたときに Airtable に注文を送信します。テンプレートを表示する

既存のすべての商品と新しい商品を Airtable に送信する

10分ごとに、(タグによって) Airtable に送信されていない商品を検索し、Airtable に送信します。テンプレートを表示する

Airtable に保存されている商品データから商品をバッチで更新する

Airtable に保存されている商品データから商品をバッチで更新します。テンプレートを表示する

SendGrid を使用して、有効期限が切れそうなギフトカードについてお客様に通知する

毎日、7日後に有効期限が切れるすべてのギフトカードを取得し、SendGrid を使用してお客様にメールを送信します。テンプレートを表示する

お客様がカスタムアイテムを注文したときに SendGrid を使用してメールを送信する

お客様がカスタムアイテムを注文したときに、SendGrid を使用して取引メールを送信します。テンプレートを表示する