Container Input (Raw HTTP)

When an external caller executes the workflow with this node via an HTTP call to the KNIME Server / Hub REST API, the HTTP body, headers, and query parameters are captured and exposed as tables. The body is outputted in binary, whereas the header and parameter tables are outputted as data tables.

This node works only with the raw-execution endpoint of the KNIME Server / Hub REST API. To learn more, check out the Hub API documentation or the API documentation of your KNIME Server.

Other container input nodes rely on body data to be provided in a JSON format. However, this "Raw HTTP Input Container" node can deal with arbitrary data, which is provided to the workflow as-is in a binary format. Therefore, the user is able to also input non-standard data, like for example an Excel spreadsheet (*.xlsx files). Furthermore, because of the removed format constraint, this input container allows for an extended compatibility with external tools.

Important: There can only be one "Container Input (Raw HTTP)" node in a workflow, as it captures the raw request. Additionally, this input node is only compatible with the "Container Output (Raw HTTP)" node. This means, no other container output node will be supported with this raw HTTP input container.

Options

File for response body
File chooser for selecting a file containing the body. Four different locations can be chosen from: Local File System, Relative to, Mountpoint and Custom URL. This default body is then returned while building the workflow when no actual request is available.
Default headers
The default headers to return while building the workflow when no actual request is available.
Default query parameters
The default query parameters to return while building the workflow when no actual request is available.

Input Ports

Icon
The file system connection for retrieving the body file.

Output Ports

Icon
Table containing a single binary body value in the column body.
Icon
Table containing one column for each header. There is a single row containing the header's value.
Icon
Table containing one column for each query parameter. There is a single row containing the header's value.

Views

This node has no views

Workflows

Links

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.