WebAction.Request

  • [アーティクル]

構文

WebAction.Request(method as text, url as text, optional options as nullable record) as action

バージョン情報

実行されると、バイナリ値として HTTP を使用する、url に対して method 要求を実行する結果を返すアクションを作成します。 省略可能なレコード パラメーター options を指定して、追加のプロパティを指定することができます。 レコードには、次のフィールドを含めることができます。

  • Query:クエリ パラメーターをプログラムで URL に追加します。エスケープについて考える必要はありません。
  • ApiKeyName:ターゲット サイトが API キーに対応している場合、このパラメーターを使用すると、URL で使用する必要があるキー パラメーターの名前 (値ではない) を指定できます。 実際のキー値は、資格情報で指定されます。
  • Headers:この値をレコードとして指定すると、HTTP 要求に追加のヘッダーが指定されます。
  • Timeout:この値を期間として指定すると、HTTP 要求のタイムアウトが変更されます。 既定値は 100 秒です。
  • ExcludedFromCacheKey:この値をリストとして指定すると、これらの HTTP ヘッダー キーが、データをキャッシュする計算から除外されます。
  • IsRetry:この論理値を true に指定すると、データをフェッチするときにキャッシュ内の既存の応答が無視されます。
  • ManualStatusHandling:この値をリストとして指定すると、応答にこれらのいずれかの状態コードが含まれる HTTP 要求に対するビルトイン処理が回避されます。
  • RelativePath:この値をテキストとして指定すると、要求を行う前にこれがベース URL に追加されます。
  • Content:この値を指定すると、その内容が HTTP 要求の本文になります。

この関数は、ほとんどのコンテキストで無効になっている点に注意してください。 代わりに Web.Contents または Web.Headers の使用を検討してください。

例 1

Bing に対して GET 要求を実行します。

使用方法

WebAction.Request(WebMethod.Get, "https://bing.com")

出力

Action