1 ×

POST Request

StreamableKNIME REST Client Nodes version 4.3.0.v202011191618 by KNIME AG, Zurich, Switzerland

This node can be used to issue HTTP POST requests. POST requests are used to send data to a web service and possibly receive data back.

The node allows you to either send a request to a fixed URL (which is specified in the dialog) or to a list of URLs provided by an optional input table. Every URL will result in one request which in turn will result in one row in the output table. You can define custom request headers in the dialog.

The sent data is usually taken from a column of the input table but you can also provide a constant value in the dialog instead.

By default the output table will contain a column with the received data, its content type, and the HTTP status code. The node tries to automatically convert the received data into a KNIME data type based on its content type. In case no automatic conversion is possible, binary cells will be created.
You can extract additional response headers into column by defining them in the dialog.

The node supports several authentication methods, e.g. BASIC and DIGEST. Other authentication methods may be provided by additional extensions.

Options

Connection Settings

URL
Select a constant URL or a column from the input table that contains the URLs that you want to request.
Delay (ms)
Here you specify a delay between two consecutive requests, e.g. in order to avoid overloading the web service.
Concurrency
Number of concurrent requests
Ignore hostname mismatches
If checked, the node trusts the server's SSL certificate even if it was generated for a different host.
Trust all certificates
If checked, the node trusts all certificates regardless of their origin or expiration date.
Fail on connection problems (e.g. timeout, certificate errors, …)
By default connection problems will result in a row with appropriate status code and error message and the node will continue. If this option is checked the node will fail if a request fails.
Fail on http errors (e.g. page not found)
By default failed requests (HTTP status codes 4xx and 5xx) will result in a row with appropriate status code and error message and the node will continue. If this option is checked the node will fail if a request fails.
Follow redirects
If checked, the node will follow redirects (HTTP status code 3xx).
Timeout (s)
Timeout for a single request in seconds
Body
Name of the response body column in the output table

Authentication

Type
The authentication type, e.g. no authentication, BASIC, or DIGEST
Use credentials
Uses the selected credentials instead of username and password provided in the dialog.
Username
The username used for authentication.
Password
The corresponding password used for authentication.

Request Headers

Merge
If you click this button the request headers from the selected template on the left are merged with the already existing header definitions in the table below.
Replace
If you click this button the request headers from the selected template on the left will replace any existing header definitions in the table below.
Header key
The HTTP header key, e.g. Accept or X-Custom-Key.
Header value
The value for the header which can be a constant value or a reference to a flow variable, a column, a credential name, or a credential password (see the kind option).
Header kind
The kind of the value specified, which is either a constant value or a reference to a flow variable, a column, a credential name, or a credential password

Request Body

Use column's content as body
Use the selected column's content as the body of the request.
Use constant body
Use the specified content below as the body of the request.

Response Headers

Extract all fields
If checked, all header fields present in the first response are extracted into columns.
Header key
The name of the header to extract.
Header type
The KNIME data type the header should be converted into.

Input Ports

Icon
Optional data table containing the variable parameters of the requests.

Output Ports

Icon
Data table containing columns from the responses.

Best Friends (Incoming)

Best Friends (Outgoing)

Workflows

Installation

To use this node in KNIME, install KNIME REST Client Extension from the following update site:

KNIME 4.3

A zipped version of the software site can be downloaded here.

You don't know what to do with this link? Read our NodePit Product and Node Installation Guide that explains you in detail how to install nodes to your KNIME Analytics Platform.

Wait a sec! You want to explore and install nodes even faster? We highly recommend our NodePit for KNIME extension for your KNIME Analytics Platform. Browse NodePit from within KNIME, install nodes with just one click and share your workflows with NodePit Space.

Developers

You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.