The action HTTP Request requests a resource from a server using the specified HTTP request method.
Note: This action is meant to be used for technical requests (REST and the like) and to process the response using scripts. If you simply want to download a file please use the action Download URL.
The action terminates with a status code of -1 for general errors. It will terminate with an error when not even a connection to the server can be established (network not available, IP can not be resolved etc.). Use an Exception-connection to handle such errors.
- Fetch a web page of a weather service and test if it contains the word rain.
- Get the price of a product from an online retailers REST service.
The URL to request. Variables are supported.
Verify certificates (https)
Whether certificates should be checked or not. Can be useful to ignore errors for self-signed certificates.
Whether username and password should be passed to the server using basic authentication.
If a client certificate should be used.
Client certificate path
Client certificate password
Whether to use the currently available default network or send the request on the WiFi or cellular network.
The HTTP request method to use. Not all methods are supported by all devices.
Form Field List
Comma separated list with key=value to send as
to the server. The values are automatically URL encoded. Variables are supported.
Form Field Name
File to upload
The path of the file to upload. The filename for the request is automatically determined based on the specified file. Variables are supported.
The timeout to use.
Custom HTTP Headers
A text containing the custom HTTP headers to send. Variables are supported.
Each line should start with the header name and a colon followed by the value to send.
User-Agent: my own user agent
Store response in a variable or file
Whether to store the response in a variable or a file.
The name of the variable to store the response in. The response is converted to a string. Variables are supported.
Responses larger than 1MB are not supported in a variable.
The encoding to use to read the response from the server. Leave empty to use the encoding as specified by the servers response.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.See action Script for a description.
name as declared in the field Variable
the response as string
the numeric HTTP status code, -1 when a general error occurs
error message when the request could not be executed and
status_code is set to -1
All values of the response headers. The name of the variable is built using the prefix
and the name of the header by replacing dash with underscore and converting the name to lowercase.
Accept is stored in variable
Accept-Encoding is stored in variable
Values of headers that are specified multiple times in the response are provided as a list.
Headers leading to an invalid variable name are ignored.