⚠️ このドキュメントはAIによって自動翻訳されています。不正確な部分がある場合は、英語版を参照してください。
HTTP リクエストノードの設定
HTTP メソッド
このノードは、さまざまなタイプの操作に対応する全ての標準 HTTP メソッドをサポートしています：- データ取得
- データ送信
- リソース管理
GET は何も変更せずにサーバーからデータを取得します。ユーザープロファイルの取得、データベースの検索、現在のステータスの取得に使用します。HEAD は完全なレスポンス本文なしでレスポンスヘッダーを取得します。リソースが存在するかどうかの確認やメタデータの取得に便利です。
設定
URL、ヘッダー、クエリパラメータ、リクエスト本文、認証を含む HTTP リクエストのあらゆる側面を設定できます。以前のワークフローノードからの変数は、リクエスト設定のどこにでも動的に挿入できます。変数置換
二重中括弧を使用してワークフロー変数を参照します：{{variable_name}}。Dify は深いオブジェクトアクセスをサポートしているため、以前の HTTP レスポンスから {{api_response.data.items[0].id}} のようなネストした値を抽出できます。
タイムアウト設定
HTTP リクエストには、ハングを防ぐための設定可能なタイムアウトがあります：- 接続タイムアウト：接続確立の最大時間（デフォルトはデプロイメントによって異なる）
- 読み取りタイムアウト：レスポンスデータ読み取りの最大時間
- 書き込みタイムアウト：リクエストデータ送信の最大時間
認証
このノードは複数の認証タイプをサポートしています： 認証なし（type: "no-auth"されません
API キー（type: "api-key"）には3つのサブタイプがあります：
- Basic（
type: "basic"）- base64 エンコーディングを使用した Basic Auth ヘッダーを追加 - Bearer（
type: "bearer"）-Authorization: Bearer <token>ヘッダーを追加 - カスタム（
type: "custom"）- 指定された名前と値でカスタムヘッダーを追加
リクエスト本文
API 要件に基づいて適切な本文タイプを選択します：- JSON 構造化データ用
- フォームデータ 従来の Web フォーム用
- バイナリ ファイルアップロード用
- 生テキスト カスタムコンテンツタイプ用
ファイル検出
HTTP リクエストノードは、高度なロジックを使用してファイルレスポンスを自動的に検出します：- Content-Disposition 分析 -
attachmentディスポジションまたはファイル名パラメータをチェック - MIME タイプ評価 - コンテンツタイプを分析してテキストとバイナリを区別
- コンテンツサンプリング - 曖昧なタイプについては、最初の1024バイトをサンプリングしてテキストパターンを検出
ファイル操作
HTTP リクエストノードは、ファイルのアップロードとダウンロードをシームレスに処理します：
ファイルアップロード設定例
エラー処理とリトライ
外部サービスに依存する本番ワークフロー用の堅牢なエラー処理を設定します：
HTTP リトライ設定
HTTP エラー処理オプション
レスポンス処理
HTTP レスポンスは、後続のノードで構造化変数となり、以下への個別アクセスが可能です：- レスポンス本文 - API によって返されるメインコンテンツ
- ステータスコード - 条件付きロジック用の HTTP ステータス
- ヘッダー - キー・値ペアとしてのレスポンスって返される任意のファイルコンテンツ
- サイズ情報 - 読み取り可能な形式（KB/MB）でのコンテンツサイズ（バイト）
SSL 検証
SSL 証明書検証はノードごとに設定可能です（ssl_verify パラメータ）。これにより、外部 API のセキュリティを維持しながら、自己署名証明書を使用する内部サービスへの接続が可能になります。
動的 API 統合ワークフロー例