Supports HTTP methods GET, POST, PUT, HEAD, DELETE with and without content. \ Supports sending asynchronous requests and requests with pending responses. +\ In case of an error, the transition is carried out along the “Error” branch, and the corresponding HTTP code is returned to the “Error code” variable. +\ The component supports sessions, storing and using cookies, as well as HTTPS and certificate verification.
Component Web request to direct URL
:icons:font :hardbreaks: :imagesdir: ../../../assets/images :toc-title: Contents :toc:
Description
Allows you to make HTTP and HTTPS requests to web services via an arbitrary URL. +\
The actual sending of the request can be made both from the server on which the current script processor is running, and from the edge servers of the “Incoplax” system.
In some cases it can be replaced by executing a "curl" request via the command line (component Start process).
Index |
|
Short name |
|
Script types |
|
Start module |
|
Mode |
Asynchronous |
Icon |
|
Branching type |
Branching, closing |
Properties
| Specification | Description |
|---|---|
Name: Proxy Code: Visibility condition: no Default: No |
Toggle proxy server use. |
Name: Proxy authentication Code: Visibility condition: yes Default: No |
Proxy authentication switch. |
Name: Proxy login Code: Visibility condition: yes Default: — |
Login to the proxy server. |
Name: Proxy password
Code: Default: — |
Password for the proxy server. |
Name: Proxy address Code: Visibility condition: yes Default: — |
Proxy server address. |
Name: Proxy port Code: Visibility condition: yes Default: — |
Proxy server port. |
Name: Max redirects Code: Visibility condition: no Default: — |
Limit on the maximum number of redirects. The value for the HTTP header is |
Name: Visibility condition: no Default: — |
Request URL. Must contain a schematic (for example, |
Name: Request Source Code: Visibility condition: no Default: — |
Server address from which to send the request. Default request is sent from the server where the handler executes the script. Possible indication formats:
where
If there is no node/role or any incorrect name setting, the sending is made from the server where the handler executes the script. If the address of the network interface of the sender’s server is missing or incorrectly specified, the sending will occur from the address of the sender’s node. |
Name: Method Code: Visibility condition: no Default: |
Possible options:
|
Name: Content Type
Code: Default: |
Value for HTTP header |
Name: Request body Code: Visibility condition: yes Default: — |
Content of the HTTP request body. |
Name: Request encoding Code: Visibility condition: yes Default: |
Encoding used to convert the request body from a string representation to a binary form before sending. Possible options:
|
Name: Name of the request encoding Code: Visibility condition: yes Default: |
Manually specified encoding name for the request body. |
Name: Basic Authentication
Code: Default: No |
Basic authentication switch. |
Name: Login Code: Visibility condition: yes Default: — |
Login for basic authentication. |
Name: Password Code: Visibility condition: yes Default: — |
Password for basic authentication. |
Name: Headings Code: Visibility condition: no Default: — |
Additional HTTP headers inserted into the request. The argument contains a multi-line value, the format of each line is: |
Name: Cookie Code: Visibility condition: no Default: — |
Additional COOKIES to be inserted into the request. The argument contains a multi-line value, the format of each line is: |
Name: Mode
Code: Default: Waiting for result |
Component operating mode after sending a request. Possible options:
|
Name: Time, s Code: Visibility condition: yes Default: — |
Timeout waiting for a response to a sent HTTP request. |
Name: Response code Code: Visibility condition: yes Default: — |
Variable for storing the HTTP response code. Not filled in if the request is not answered. If the request ends with a 3xx response, then a new forwarded request is initiated and the 3xx response code is subsequently overwritten. |
Name: Response headers Code: Visibility condition: yes Default: — |
Variable for storing HTTP response headers. Not filled in if the request is not answered. If the request ends with a 3xx response, then a new forwarded request is initiated and the headers are subsequently rewritten. |
Name: Reply Code: Visibility condition: yes Default: — |
Variable for storing the HTTP response body. Not filled in if the request is not answered. If the request ends with a 3xx response, then a new forwarded request is initiated and the body is subsequently overwritten. |
Name: Response encoding Code: Visibility condition: yes Default: |
The encoding in which the body of the HTTP response is located. Used to convert to a string representation in a script variable. Possible options:
|
Name: Name of the response encoding Code: Visibility condition: yes
Default: |
Manually specified encoding name for the response body. |
Name: Error Code: Visibility condition: no Default: — |
Variable for storing the HTTP error code along with a phrase, for example '404 Not Found'. |
Name: Transition
Code: Default: — |
The component to which control is transferred if the asynchronous sending operation completes successfully, or an HTTP response is received. |
Name: Transition, time Code: Visibility condition: yes Default: — |
The component to which control is transferred in the event of a timeout waiting for a response. |
Name: Transition, error Code: Visibility condition: no Default: — |
The component to which control is transferred in the event of an error sending a request or receiving an unsuccessful response (codes |
See also
-
Role svc