HTTPリクエスト
Last updated
Last updated
HTTP プロトコルを介してサーバーにリクエストを送信することを可能にし、外部データの取得、ウェブフック、画像生成、ファイルのダウンロードなどのシナリオに適用されます。指定されたネットワークアドレスにカスタマイズされたHTTPリクエストを送信し、さまざまな外部サービスとの連携を実現します。
このノードは一般的なHTTPリクエストメソッドをサポートしています:
GET、リソースをサーバーにリクエストするために使用されます。
POST、データをサーバーに送信するために使用され、通常はフォームの送信やファイルのアップロードに使用されます。
HEAD、GETリクエストに似ていますが、サーバーはリソースの本体を返さず、レスポンスヘッダーのみを返します。
PATCH、リクエスト-レスポンスチェーンの各ノードで伝送経路を取得するために使用されます。
PUT、リソースをサーバーにアップロードするために使用され、通常は既存のリソースの更新や新しいリソースの作成に使用されます。
DELETE、指定されたリソースをサーバーに削除するようにリクエストするために使用されます。
HTTPリクエストのURL、リクエストヘッダー、クエリパラメータ、リクエストボディの内容、および認証情報などを設定することができます。
アプリケーションからサーバーへの対話型コンテンツの送信
HTTPリクエストにおいて、ユーザー名や顧客ID、フィードバック内容など、様々な動的な変数を挿入することが可能です。たとえば、顧客のフィードバックを扱う際に、これらの変数を使用して自動返信メッセージをパーソナライズしたり、特定の顧客データを取得してそれに関連する情報を特定のサーバーに送信したりすることができます。
HTTPリクエストのレスポンスには、レスポンスボディ、ステータスコード、レスポンスヘッダー、そしてファイルが含まれることがあります。特にレスポンスにファイルが含まれる場合、この機能は自動的にファイルを保存し、後のプロセスステップでの利用を可能にします。これにより、処理効率が向上し、ファイルを含むレスポンスをより直接的かつ容易に扱えるようになります。
ファイルの送信
HTTP PUTリクエストを利用して、アプリケーション内のファイルを他のAPIサービスへ送信することができます。リクエストのボディ内で、binary
オプションからファイル変数を選択することにより、ファイル転送、文書の保存、メディアの処理など、様々な場面でこの方法が活用されます。
例えば、文書管理アプリケーションを開発中に、ユーザーがアップロードしたPDFファイルを外部サービスに同期し、送信する必要がある場合、HTTPリクエスト機能を用いてファイル変数を送信することが可能です。
設定の一例は以下のとおりです:
<最初の翻訳の問題点の改善ポイント> この再翻訳では、日本語の表現习慣に合わせ、より自然で明瞭な表現を心がけました。具体的な専門用語やプロセスの説明も、より分かりやすく説明するよう努めています。このように、原文の意味を正確に伝えつつ、読みやすさも重視した翻訳を目指しました。
HTTPノードが情報を処理する過程で、ネットワークのリクエストがタイムアウトしたり、リクエストの制限に遭遇したりするなど、予期せぬエラー状況が発生することがあります。アプリケーションの開発者は、エラーが生じた際にプロセスが中断されないように、下記の手順に沿ってエラー処理の設定を行うことで、これらの問題に対処できます。
HTTPノードで「エラー処理」機能を有効化する。
必要に応じて、具体的なエラー処理の対策を選択し、設定する。
エラー処理の具体的な方法についてさらに知りたい場合は、こちらのエラー処理ガイドを参照してください。