HTTP Request
Description
The HTTP Request action allows a Flow to perform an HTTP action on an REST endpoint.
Additional configuration can be passed like Headers, ContentType (list of most important MIME types) and Content.
After executing the request it will return the HTTP response status code and the response content as string.
Usage
This action could be used for example to POST or DELETE to an endpoint, in order to create, update or delete a REST resource.
It can also be used to GET HTTP request method to retrieve data to pass to the next action.
There are three types of authentication for the request:
None: No authentication needed.
Basic: Basic authentication is a simple authentication scheme built into the HTTP protocol. The client sends HTTP requests with the Authorization header, that contains the username and password encoded in base64 form.
Bearer: Bearer authentication (also called token authentication) is an HTTP authentication scheme that involves security tokens called bearer tokens. The name Bearer authentication can be understood as give access to the bearer of this token.
Input samples in JSON notation
Authentication type: None
{
'AuthenticationType': 'None'
'Method': 'string',
'Url': 'string',
'ContentType': 'string',
'Content': 'string',
'Headers': {
'key': 'value'
}
}
Authentication type: Basic
{
'AuthenticationType': 'Basic',
'Username': 'string',
'Password': 'string',
'Method': 'string',
'Url': 'string',
'ContentType': 'string',
'Content': 'string',
'Headers': {
'key': 'value'
}
}
Authentication type: Bearer
{
'AuthenticationType': 'Bearer',
'Token endpoint': 'string',
'Client': 'string',
'Client Secret': 'string',
'Requested Scope': 'string',
'Method': 'string',
'Url': 'string',
'ContentType': 'string',
'Content': 'string',
'Headers': {
'key': 'value'
}
}
Output sample
{
'StatusCode': 200,
'Headers': {
'key': [
'value'
]
},
'Response': 'string'
}
}
Certificates
A Client Certificate can be attached to the HTTP request sent, this can be done under "Advanced configuration" section. In this section, a dropdown is displayed and will allow the user to select one of the certificates that have been added for this tenant.
There is also the option to attach a Remote Certificate, providing added identity authentication on received data through a mTLS protocol. You can find more info about setting up certificates here.
NOTE In order to add a Remote Certificate to the HTTP request a Client Certificate must be already provided.
Multipart/form-data content type support
The HTTP Request action supports the usage of multipart/form-data
content type.
Once the content type is selected, a new Form Data
section will be displayed, where the Form Data can be configured.
Form Data fields can be added and configured using the Add
button and filling the information in the popup.
There are two types of fields available: Text
and File
:
- The
Text
form data value requires thekey
andvalue
provided in the configuration. - The
File
form data value requires akey
, the file contentvalue
and afilename
. The supported file content is plain text for text files (XML, CSV, Json, etc...) andBase64
encoding for binary files (PDF, PNG, etc...).
Binary application/octet-stream content type support
The HTTP Request action supports the usage of Binary application/octet-stream
content type.