HTTP リクエスト

このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版を参照してください。

HTTP リクエストノードは、ワークフローを外部 API や Web サービスに接続します。データの取得、ウェブフックの送信、ファイルのアップロード、または HTTP リクエストを受け入れる任意のサービスとの統合に使用できます。

HTTP メソッド#

このノードは、さまざまなタイプの操作に対応する全ての標準 HTTP メソッドをサポートしています：

GET は何も変更せずにサーバーからデータを取得します。ユーザープロファイルの取得、データベースの検索、現在のステータスの取得に使用します。

HEAD は完全なレスポンス本文なしでレスポンスヘッダーを取得します。リソースが存在するかどうかの確認やメタデータの取得に便利です。

URL、ヘッダー、クエリパラメータ、リクエスト本文、認証を含む HTTP リクエストのあらゆる側面を設定できます。以前のワークフローノードからの変数は、リクエスト設定のどこにでも動的に挿入できます。

二重中括弧を使用してワークフロー変数を参照します：{{variable_name}}。Dify は深いオブジェクトアクセスをサポートしているため、以前の HTTP レスポンスから {{api_response.data.items[0].id}} のようなネストした値を抽出できます。

Secret タイプの環境変数の値は、ワークフロー実行ログとこのノードのリクエストログでマスクされて表示されます。

HTTP リクエストには、ハングを防ぐための設定可能なタイムアウトがあります：

タイムアウトは、ワークフローのパフォーマンスを維持し、リソースの枯渇を防ぐために適用されます。

このノードは複数の認証タイプをサポートしています：

認証なし（type: "no-auth"されません

API キー（type: "api-key"）には 3 つのサブタイプがあります：

API 要件に基づいて適切な本文タイプを選択します：

HTTP リクエストノードは、高度なロジックを使用してファイルレスポンスを自動的に検出します：

テキストベースのレスポンス（JSON、XML、HTML など）は通常のデータとして扱われ、バイナリコンテンツはファイル変数になります。

HTTP リクエストノードは、ファイルのアップロードとダウンロードをシームレスに処理します：

ファイルアップロード はバイナリリクエスト本文オプションを使用します。以前のノードからファイル変数を選択して、文書保存、メディア処理、またはバックアップのために外部サービスにファイルを送信します。

ファイルダウンロード は、レスポンスにファイルコンテンツが含まれている場合に自動的に処理されます。ダウンロードされたファイルは、下流のノードで使用するためのファイル変数として利用可能になります。

外部サービスに依存する本番ワークフロー用の堅牢なエラー処理を設定します：

リトライ設定 は、設定可能な間隔（最大 5000ms）で失敗したリクエストを最大 10 回まで自動的にリトライします。これは、一時的なネットワークの問題やサービスの利用不能を処理します。

エラー処理 は、HTTP リクエストが失敗した場合の代替ワークフローパスを定義し、外部 API が利用できない場合でもワークフローが実行を継続することを保証します。

HTTP レスポンスは、後続のノードで構造化変数となり、以下への個別アクセスが可能です：

SSL 証明書検証はノードごとに設定可能です（ssl_verify パラメータ）。これにより、外部 API のセキュリティを維持しながら、自己署名証明書を使用する内部サービスへの接続が可能になります。

API データ取得 - ユーザープロファイル、製品情報、または外部データを取得して、ワークフロー処理を充実させます。

ウェブフック配信 - 通知、ステータス更新、または処理結果を外部システムやサービスに送信します。

ファイル処理 - 分析用の文書をアップロード、さらなる処理用のリソースをダウンロード、またはクラウドストレージサービスとの統合。

マルチステップ API ワークフロー - 複数の API 呼び出しを連鎖させ、一つのリクエストからのレスポンスを使用して後続のリクエストを設定します。