メインコンテンツへスキップ

HTTP node

HTTP node を使用すると、フローから直接、外部 API またはサービス へ HTTP リクエストを送信できます。サードパーティシステムとの連携、REST API からのデータ取得、Webhook や外部エンドポイントへのデータ送信に使用します。

HTTP リクエストのレスポンス本文はノードの出力となり、フロー内の後続ノードから利用できます。

Automatic parsing of YAML and CSV​

レスポンス本文が YAML（.yml / .yaml）または CSV（.csv）の場合、HTTP node は自動的に JSON へパースします。下流のノードは、パース済みの JSON（オブジェクトまたは配列）を受け取り、他の API レスポンスと同様に参照できます。判定にはレスポンスの Content-Type ヘッダーまたはリクエスト URL パス（例: .yml や .csv で終わる URL）を使用します。CSV の場合、最初の行はヘッダーとして扱われ、結果は各行 1 件のオブジェクトからなる配列になります。

生のレスポンス本文は保持されず、ノード出力はパース済みの結果のみになります。パース前の元の YAML または CSV を確認するには、Test タブを使用してください。パースに失敗した場合、ノード出力は詳細情報を含むエラーオブジェクトになります。

Configure the HTTP request​

HTTP node を選択すると、Parameters と Test の 2 つのタブを持つサイドパネルが開きます。

Parameters​

Parameters タブで、次の設定を行います。

URL、本文、ヘッダーやクエリの値には、+ または @ を使用して前のノードからの動的な値を挿入できます。リクエスト送信前に値を変換する必要がある場合は、通知メッセージと同様に {{ }} のフォーマットルールも使用できます。参照を挿入する際は、プレーンテキストとしてパスを入力するのではなく、必ず + または @ を使用してください。詳しくは、Highlighted references を参照してください。

HTTP フィールド内の配列については、1 回のリクエスト内で配列として保持するために角括弧付きの参照を使用してください（例: [<reference>]）。角括弧を付けない場合、値が複数のリクエストに展開されることがあります。

  • URL（必須）: HTTP リクエストのエンドポイント URL。+ ボタンを使用して、前のノードからの動的な値を挿入できます。フィールドタイプおよび値の参照方法については、Node parameters を参照してください。

  • Method（必須）: 使用する HTTP メソッド。GET、POST、PUT、PATCH、DELETE をサポートします。

Query params​

リクエスト URL に付加するクエリパラメータを追加します。Add new query param を選択して、キーと値のペアを定義すると、それらは自動的に URL にクエリ文字列パラメータとして付加されます。

Headers​

ヘッダーを設定することで、各リクエストに認証情報やその他のカスタムデータを送信できます。ヘッダーは、Bearer トークン（OAuth 2.0）、Basic 認証、API キーなどの一般的な認証方式をサポートします。ノード間で認証情報を再利用するには、フロー変数に保存し、ヘッダー追加時にそれらの変数を参照してください。

Headers パラメータでヘッダーを設定します。Add new header を選択して、Authorization、Content-Type、その他ターゲット API に必要な任意のカスタムヘッダーなどのキーと値のペアを定義してください。

Body​

POST、PUT、PATCH など、本文をサポートするメソッド向けにリクエスト本文を入力します。+ ボタンを使用して、前のノードからの動的な値を挿入できます。

ヒント

チップが角括弧で囲まれている場合、値の配列としてレンダリングされます。角括弧がない場合は、各リクエストに単一の値としてレンダリングされます。

Pagination​

Use pagination を有効にすると、ページネーションされた API レスポンスを自動的に処理します。API が複数ページにわたって結果を返し、単一のフロー実行でそれらをすべて取得する必要がある場合に便利です。

HTTP client config​

HTTP クライアントの動作を詳細に設定します。

  • Timeout (seconds): レスポンスを待機する最大時間。これを超えるとリクエストはタイムアウトします。デフォルトは 30 秒です。

  • Max retries: 失敗したリクエストを再試行する回数。デフォルトは 3 回です。

  • Follow redirects: 有効にすると、HTTP クライアントは 301、302 などのリダイレクトレスポンスに自動的に追従します。デフォルトで有効です。

Test​

ノードをテストするには、Test を選択してください。

Example: Fetch carbon intensity for an AWS region​

この例では、HTTP node を使用して、Electricity Maps API を通じて us-east-1 AWS リージョンの現在のカーボンインテンシティを取得する方法を示します。これは、リージョン間での二酸化炭素排出量を監視・比較し、サステナビリティ目標の達成を支援する FinOps フローで有用です。

注意

この例に従うには、Electricity Maps プラットフォームで無料の API キーを作成してください。

HTTP node を次の設定で構成します。

FieldValue
URLhttps://api.electricitymaps.com/v3/carbon-intensity/latest
MethodGET
Query paramszone = US-MIDA-PJM
Headersauth-token = Electricity Maps の API キー

US-MIDA-PJM ゾーンは PJM グリッドに対応しており、これは us-east-1 AWS リージョンをカバーしています。

HTTP node configured for Electricity Maps API

Test を選択してリクエストを送信します。成功したレスポンスでは、そのゾーンの現在のカーボンインテンシティが返されます。

{
  "zone": "US-MIDA-PJM",
  "carbonIntensity": 406,
  "datetime": "2026-02-15T20:00:00.000Z",
  "updatedAt": "2026-02-15T19:25:13.450Z",
  "createdAt": "2026-02-15T08:39:54.714Z",
  "emissionFactorType": "lifecycle",
  "isEstimated": true,
  "estimationMethod": "SANDBOX_MODE_DATA"
}

HTTP node test output showing carbon intensity response

その後、このデータを後続のノードで使用できます。例えば、Branch node で carbonIntensity が閾値を超えているかをチェックし、Notification node で排出量が高い場合にステークホルダーへ通知する、といった使い方が可能です。

に最終更新