

Figure 1: HTTP Request Node
Description


By using the HTTP Request Node you are able to perform a HTTP request to a specific resource from within a Flow.
Whenever the HTTP Request Node gets triggered within a Flow execution it will perform the defined request to the specified URL.


Figure 2: HTTP Request Node Configuration Prompt
Request Methods


The HTTP Node can execute the typical CRUD methods, which are:
- GET
- POST
- PUT
- DELETE
General Configuration


Each request method has certain fields which it shares with the other methods. These are the fields:
- URL
- Headers
- Authorization Type
- Context Store
- Async
- Caching
- Cache Expiry
URL
The URL to the targeted resource.


Figure 4: URL field
URL-Encoding
Cognigy.AI expects an un-encoded URL to the targeted resource. Please decode any encoded URL to ensure that the HTTP Request can be executed successfully.
For more information see URL encoding (on en:WP).
Headers
Here you can add the headers you need to successfully perform the HTTP request, in JSON format.


Figure 5: Headers fields
Authentication
The supported types are:
- No Auth
- Basic Auth
- OAuth2
- API Key - "Authorization: ApiKey"
- API Key - "X-API-Key"
Authentication makes use of Connections, which means that the actual authentication information can be encrypted.


Figure 6: Authorization Selection
In case you select an authorization type other than No Auth, additional fields will be provided which relate to the respective authorization type.
Storage Options
Here you define the context key where you want to store the response from the executed HTTP request. This field is required and needs to have a valid value.


Figure 7: Context Store field
After the HTTP request has been successfully executed you can access the response payload by executing the following CognigyScript:
{{cc.<yourContextStore>}}


Execution & Caching
Execute Requests asynchronously
When enabled, the HTTP Request Node will execute the request asynchronously, meaning that it will not wait for a response before continuing flow execution
Cache Results
When enabled the HTTP Node will cache the responses.
GET Requests


The GET method configuration prompt has all the fields described above.
The results of the GET request are stored in the context of the flow. You can retrieve the requested data of your GET request by accessing the context with the key you defined in the HTTP Node settings.
POST Requests


Content-Type Headers
The standard Content-Type header is application/x-www-form-urlencoded. If you want to send another Content-Type, you have to set the header value specifically or use JSON as described below.
Payload
Here you can define the payload of your POST request. You can choose between JSON (standard) and Text.


Figure 8: JSON as a POST Request Payload
application/x-www-form-urlencoded
You can send URL Encoded data by setting no specific header and then sending a URLEncoded non-JSON payload such as "To=%2B49555262626&Url=https%3A%2F%2Fhandler.twilio.com%2Ftwiml%2FEHf9b7af093c31b5baa1414be891"
PUT Requests


Aside from the General Configuration fields (see above), the PUT request configuration prompt exposes the same configuration fields as the POST request configuration prompt.
DELETE Requests


The DELETE request configuration prompt exposes the General Configuration fields (see above).
Updated 7 days ago
What's Next
NLU |