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

HTTP ノード

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

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

YAML と CSV の自動パース​

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

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

HTTP リクエストの設定​

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

Parameters​

Parameters タブで次の設定を構成します。

  • URL（必須）: HTTP リクエストのエンドポイント URL。+ ボタンを使用して、前のノードからの動的な値を挿入できます。パラメータタイプと値の参照方法については、Parameter types を参照してください。

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

Query params​

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

Headers​

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

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

Body​

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

ヒント

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

Pagination​

Use pagination を有効にして、ページネーションされた API レスポンスを自動的に処理します。これは、API が複数ページに分割された結果を返し、それらを 1 回のフロー実行で全件取得する必要がある場合に有用です。

HTTP client config​

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

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

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

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

Test​

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

例: AWS リージョンのカーボンインテンシティを取得する​

この例では、Electricity Maps API を使用して、us-east-1 AWS リージョンの現在のカーボンインテンシティを取得するために HTTP ノードを使用する方法を示します。これは、リージョン間でカーボン排出量を監視または比較し、サステナビリティ目標を支援する FinOps フローに役立ちます。

注意

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

HTTP ノードを次の設定で構成します。

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 で排出量が高い場合にステークホルダーへ通知することができます。

に最終更新