HTTP Client
Methods PUT, DELETE, and HEAD available since 2022.1.2
Last updated
Methods PUT, DELETE, and HEAD available since 2022.1.2
Last updated
The HTTP Client Node allows the user to send HTTP requests to a selected HTTP server. All configurations are made in the Node or in the Attributes section. There are several methods that the user can select from to perform different HTTP requests. These are: GET, POST, PUT, HEAD, and DELETE.
Scope: Project, Scene, Function, Prefab.
Depending on the Method selected, the Attributes and Inputs might change. However, there are several common Attributes, Inputs, and Outputs between the many HTTP Methods.
Remote IP
User Input
The HTTP endpoint (either a URL or IP address).
Remote Port
Int
The port value. For HTTP, the standard is 80 and for HTTPS, the standard is 443.
Method
Drop-down
Either GET, POST, PUT, HEAD, or DELETE.
Path
User Input
A specific path from the call being referenced in Remote IP. Usually, this is the text after the main root URL but before the ? character.
Authentication
Drop-down
The user selects Basic when a username and password are required to access the information, otherwise None is chosen.
Default Headers
Add Elements
HTTP headers in the form of key/value pairs.
Request Query
Add Elements
Parameters of the call in the form of key/value pairs.
Is Response Body Binary
Bool
The user chooses true or false depending on whether they wish for the Response Body output to remain a String or be converted into binary. Currently, the Node only supports Strings.
Pulse Input (►)
Pulse
A standard Input Pulse, to trigger the execution of the Node.
Remote IP
String
The HTTP endpoint (either a URL or IP address).
Remote Port
Int
The port value. For HTTP, the standard is 80 and for HTTPS, the standard is 443.
Path
String
A specific path from the call being referenced in Remote IP. Usually, this is the text after the main root URL but before the ? character.
Headers
Dictionary
HTTP headers in the form of key/value pairs.
Query
Dictionary
Parameters of the call in the form of key/value pairs.
Pulse Output (►)
Pulse
A standard Output Pulse, to move onto the next Node along the Logic Branch, once this Node has finished its execution.
OnResponse (►)
Pulse
Flows to additional actions when there is a response.
Status Code
Int
A standard status code within the HTTP protocol. For example, 404 is when a page is not found.
Headers
Dictionary
HTTP headers in the form of key/value pairs.
Body
String
The body of the response, usually including HTML text.
GET creates a request and returns the response as per the HTTP protocol. This is very useful when dealing with web APIs. A more detailed explanation involving web APIs can be found in the See Also section. Additional information on the different HTTP methods can be found in the External Links section.
POST sends data, in this case the information from the Request Body, to the desired server as per the HTTP protocol. More information on the different HTTP methods can be found in the External Links section. All Attributes and Inputs are the same as the common Attributes, except for the addition of the following:
Default Body
String
The body of the HTTP request, if none is provided in the Input Socket.
Body
String
The body of the HTTP request.
PUT updates already existing data on the desired server per the HTTP protocol. More information on the different HTTP methods can be found in the External Links section. All Attributes and Inputs are the same as the common Attributes, except for the addition of the following:
Default Body
String
The body of the HTTP request, if none is provided in the Input Socket.
Body
String
The body of the HTTP request.
HEAD requests the headers on the desired server in order to gather information about the data, but not the content of the data itself. More information on the different HTTP methods can be found in the External Links section. All Attributes and Inputs are the same as the common Attributes.
DELETE deletes data on the desired server per the HTTP protocol. More information on the different HTTP methods can be found in the External Links section. All Attributes and Inputs are the same as the common Attributes, except for the addition of the following:
Default Body
String
The body of the HTTP request, if none is provided in the Input Socket.
Body
String
The body of the HTTP request.
Different HTTP Methods on W3Schools.
