Call Rest API

This handler (com.rierino.handler.RestAPIEventHandler) provides ability to make REST based calls to other internal or external services and return their results for API-based integrations.

Handler Parameters

This handler requires no parameters. Instead, target rest system referred to by name using 'domain' field defines the base URL and credentials for all calls. This handler is cacheable.

Actions

CallRest

Makes a REST call and returns the result. Event metadata fields applicable for this action are as follows:

Table

Field	Definition	Example	Default
Domain	Name of the system to make REST call to (url and auth parameters of this system are used)	erp	-
Input Element	Json path for the input in request event payload	parameters	-
Output Element	Json path for the output in response event payload	$.product	-

JSON Schema

With event metadata parameters as:

Table

Parameter	Definition	Example	Default
Input Pattern	JMESPath pattern to apply on data input	{id:parameters.productid}	-
Output Pattern	JMESPath pattern to apply on data output, before returning response	{id:id, stock:totalUnits}	-
Url	Url path on the target system for REST call	GetInventory	-
Append Url Path	Payload element to add to the end of REST call url path	parameters.language	-
Auth Path	Payload element to use for auth.* parameters of REST system	parameters.auth	-
Method	Call method to use	POST	GET
Content Type	Content type for REST calls (none, query, application/json, application/xml, text/xml, text/plain, multipart/form-data, application/x-www-form-urlencoded)	application/xml	application/json
Headers	Json string defining list of headers to add to the request	{"content-encoding":"br"}	-
Query.*	Query parameters to pass on the request URL	language=en-US	-

JSON Schema

Example

Input

{
    "parameters": {
        "measures": "Population"
    }
}

Event Metadata

For contentType = "multipart/form-data", files can be added as fields using the following fields (all other fields are sent as text fields):

• $type: Should be set as "FILE"

• body: Text or JSON body to be sent as file contents

• fileName: File name to use for sending contents

• mimeType: Mime-type for the file contents

Example: {"$type": "FILE", "body": {test: true}, "fileName": "test.json"}

Depending on the response format, this handler returns the following data:

Format	Process
json	Response is returned as is
xml	Response is converted to json format
plain	Response is returned as {"text": [text]}
html	Response is returned as {"html": [html]}

ProduceRest

Produces rest call details without executing them for debugging purposes. Uses the same parameters as CallRest action.

Commands

RECONFIGURE

Reloads all REST target system properties, injecting connection and credential parameters with latest values. Typically used if the base URLs or API credentials change for the target system.