説明
HTTP Requestコンポーネントを使用すると、指定したURLへHTTPリクエストを送信することができます。HTTP Requestコンポーネントは入力ペイロードをプロパティに応じてHTTPリクエストのBodyコンテンツとしてHTTPリクエストを実行し、そのHTTPレスポンスのBodyを出力ペイロードに書き出します。
Content-TypeプロパティによるHTTPリクエスト時のBodyの内容
| Content-Typeプロパティ | リクエスト時のBodyの内容 |
|---|---|
| なし | 入力ペイロードはBodyに設定されずにHTTPリクエストを実行 |
| デフォルト | 入力ペイロードの型に応じてContent-Typeを自動で選択 |
| 文字列型 | 「text/plain; charset=utf-8」でPayloadを文字列としてHTTPリクエストを実行 |
| JSON配列、JSONオブジェクト | 「application/json」として、Payloadをマーシャリングしたバイト列でHTTPリクエストを実行 |
| バイト列 | 「application/octet-stream」にしてPayloadを文字列に変換したものをBodyとしてHTTPリクエストを実行 |
| その他 | 「text/plain」にして文字列に変換したものをBodyとしてHTTPリクエストを実行 |
| application/x-www-form-urlencoded | 入力ペイロードはJSONオブジェクト型として、キーと値を「=」ではさみ、それぞれを&で区切った形でBodyにした上で、HTTPリクエストを実行 |
| multipart/form-data | 入力ペイロードはJSON Object型として、キーと値をマルチパートで区切り、Content-Typeのmultipart/form-dataはバウンダリを自動的に付加してHTTPリクエストを実行 |
| その他の任意に入力されたContent-Type | 入力されたContent-Typeで入力ペイロードをバイト列にしたものをBodyとして出力 |
入力と出力のペイロード
| 入力ペイロード | 説明 |
|---|---|
| cv.Payload | HTTPリクエストのBody |
| 出力ペイロード | 説明 |
|---|---|
| cv.Payload | HTTPレスポンスのContent-Typeヘッダが"application/json"の場合はJSON型、"text/*"でcharsetが指定されている場合は文字列として、その他のContent-Typeヘッダの場合はバイト列のまま格納 |
| cv.RawBody | HTTPレスポンスのBodyをバイト列のまま格納 |
コンポーネントプロパティ
| プロパティ名 | 説明 |
|---|---|
| HTTPメソッド | GET、POST、HEAD、PUT、DELETE |
| URL | HTTPリクエストを送信するURL |
| Content-Type | HTTPヘッダのContent-Type |
| 認証方式 | なし、ベーシック認証、ベーシック/ダイジェスト認証、Bearer認証 |
| ユーザ名 | ベーシック認証ユーザ名 |
| パスワード | ベーシック認証パスワード |
| トークン | Bearerトークン |
| リトライ回数 | サーバとのコネクションが確立できないエラー、HTTPレスポンスが受信できないエラー、HTTPレスポンスが500以上、408と429の場合にリトライをする回数 |
| リトライ間隔 | リトライする場合の次にリトライするまでの間隔値 |
| タイムアウト | HTTPリクエストのレスポンスタイムアウト値 |
| プロキシURL | Proxy利用時のURL |
| プロキシユーザ名 | Proxy利用時のユーザ名 |
| プロキシパスワード | Proxy利用時のパスワード |
| リクエスト/レスポンスダンプ | なし、Bodyなし、Bodyあり |
コンポーネント変数
| コンポーネント変数 | 説明 |
|---|---|
| cv.Payload | レスポンスのbody |
| cv.StatusCode | リクエスト結果 |
| cv.Headers | レスポンスのヘッダー |
| cv.ContentLength | レスポンスの長さ |