Http Config

Summary

The Http Config contains all the possible parameters of an HTTP request. Read the article: HTTP and Web APIs, for more details on the protocol.

Several Http Configs are present in a RestNetwork tree. All three of the RestNetwork, RestQueryFolder and RestQuery have an Http Config in their properties.

The Http Config of RestQuery has highest priority, and all parameters that are entered will be written in the HTTP request. The order of priority decreases towards the RestNetwork. There are some peculiarities with the Headers and the Success Conditions, (see below).

Properties

 Permanent

• Headers: Contains a list of headers. Headers are {name : value} pairs, but this value may be a list. To create a list of values, simply create multiple headers with the same name and set their Override property to false. The priority mechanism works provided this property is true. If it is false for all headers of the same name, then they will all be grouped as a list.
• Parameters: Contains a list of parameters to insert at the end of the URL. Lists here are not managed as they are for headers. Furthermore, if two parameters with different names are entered at two levels (RestNetwork and RestQuery for example), then both parameters will be added to the query.
• Props: Contains a list of properties which will be applied to the connection
• Success Conditions: Contains a list of the success conditions for the query, (see Conditions).
• Authentication: Contains a single authentication policy. Currently only basic authentication is provided for, (see Authentications).
• CustomVariables: Contains a list of variable. The input on the left defines the name of the variable, the right input defines the value of the variable. The variables can be reused in the other slots of the component, it must use the following format: $(myVariable). The slot on the right handles SFormat

Dynamic

• Hostname: Stores the host name or IP address of the server to contact. Example: google.com or 192.168. 5.215
• Query: This is the part of the URL after the host name. Example: /api/resource/temp/1Protocol: Chooses the communication protocol, which can be HTTP or HTTPS.
• Method: Chooses the HTTP method to perform the query, which can be GET, POST, PUT, DELETE.
• Port: Chooses the port used. The standard port is 80  for HTTP and 443 for HTTPS. This does not need to be entered if the standard ports are used.
• Body: Contains the body content for a Content-Type equal to "application/json". (No need to specify the content type in the headers, it will be added by default)
• Form: Contains the body content for a Content-Type equal to "multipart/form-data" or "application/x-www-form-urlencoded". Handles multiple keys with the same value and also allows to send files, simply add the ord of a file in the station in the value slot.
• Cache: Allows choice of whether the RestNetwork should use cached queries or should request  renewal of the resource. For APIs, it is preferable to leave this property as false.
• Timeout: Specifies the waiting time to link to the server and retrieve the content.  Be aware that the response time of a request depends on the speed of the network. This property has priority over the timeout slot of the RestNetwork. It is advisable to enter a value.

 Dynamic properties must be added or removed using the actions below.

Actions

• Add Overriding Property: Allows one of the dynamic properties above to be added.
• Remove Overriding Property: Allows one of the dynamic properties above to be deleted.