Skip to main content

GET (REST)

Synopsis​

Sends a GET http request to a REST service as is used in CRUD operations to download data.

Description​

This operator can send GET requests to REST services. It can deal with returning text (e.g. JSON or XML) as a document, as well as returning binary data as a file.

By default, if a web service returns an error in the 4xx or 5xx range, this operator will fail. Sometimes however, some requests may be expected to fail, but the process should still continue (and for example return the error in the output document). In those cases, deselect the fail_on_endpoint_error parameter to keep the process going.

Differentiation​

Sends a DELETE request to a REST service. This is mostly used to delete a resource.

​

Sends a PATCH request to a REST service. This is mostly used to update parts of an existing resource.

​

Sends a POST request to a REST service. This is mostly used to create a new resource.

​

Sends a PUT request to a REST service. This is mostly used to replace an existing resource or put a resource at a specific location.

Output​

response​

The output port. Depending on whether json or binary mode is set in the response body, this returns a document or a file.

Parameters​

Request url​

The REST service URL which the operator should call.

Response body type​

Whether the result of the REST service is text or binary data. This parameter determines the result type of this operator (document or file).

Request headers​

Additional headers to include in the request. Can be for example used to log into protected services via an "Authorization" header.

Inject connection secret​

Enables the injection of a connection secret by replacing the identifier and secret placeholders defined in the selected connection entry with their respective values.

Connection entry​

This parameter is only available when inject connection secret is enabled. This parameter is used to specify a repository location that represents a connection entry.

Fail on endpoint error​

By default, if a web service returns an error in the 4xx or 5xx range, this operator will fail. Sometimes however, some requests may be expected to fail, but the process should still continue (and for example return the error in the output document). In those cases, select this checkbox to keep the process going. Note that this operator will still fail if the call fails for technical reasons, e.g. the URL cannot be reached.