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.

REST Request

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.

Basic Authentication

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.

Bearer Authentication

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.

Certificate dropdown

Multipart/form-data content type support

The HTTP Request action supports the usage of multipart/form-data content type.

Multipart/form-data dropdown

Once the content type is selected, a new Form Data section will be displayed, where the Form Data can be configured.

Multipart/form-data form list

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:

Multipart/form-data form text Multipart/form-data form file

Binary application/octet-stream content type support

The HTTP Request action supports the usage of Binary application/octet-stream content type.

Content type dropdown menu for Binary application/octet-stream