node-red-contrib-fetch 0.2.0

A Node-RED node that uses the Fetch API to make HTTP requests.

npm install node-red-contrib-fetch

node-red-contrib-fetch

A simple Node-RED node for fetching data from HTTP endpoints using the fetch API.

Install

npm install node-red-contrib-fetch

Features

  • GET, POST, PUT, DELETE and other HTTP methods
  • Custom request headers
  • JSON and text payload handling
  • Outputs the response body as msg.payload

Usage

  • Endpoint node: configure a fetch-endpoint with baseURL, optional Basic Auth (username/password), API key (apiKeyKey/apiKeyValue), and TLS options (caCertPath, rejectUnauthorized). The endpoint's baseURL is prepended to request url values.

  • Request node: the fetch-request node selects an Endpoint and makes HTTP requests. Key properties:

  • Method: HTTP verb (GET, POST, PUT, PATCH, DELETE, ...).

  • URL: path appended to the endpoint baseURL (or set msg.url to override at runtime).

  • Params / Headers: editable lists with typed inputs (str, msg, flow, global) for keys and values.

  • Return type: json, text, or arraybuffer — parsed into msg.payload.

  • Return headers/status: enable to put response headers into msg.headers and status code into msg.statusCode.

  • Validate status: treat non-2xx responses as errors when enabled.

  • Keep-Alive / Timeout: reuse connections and set request timeout (ms).

Message properties

  • msg.payload — request body (for POST/PUT/PATCH/DELETE) and parsed response body on output.
  • msg.headers — custom request headers (can also be provided via node config).
  • msg.params — request query parameters (can also be provided via node config).
  • msg.url — when set, overrides the node's configured URL for that message.

Node status

  • Status tags: s = successful requests (2xx), err = failed requests, rt = last response runtime (ms).
  • Colors: green = success, blue = in progress, red = failed.

For details and examples see the node edit dialogs in the Node-RED editor.

License

MIT

Node Info

Version: 0.2.0
Updated 2 days ago
License: MIT
Rating: not yet rated

Categories

Actions

Rate:

Downloads

124 in the last week

Nodes

  • fetch-endpoint
  • fetch-request

Keywords

  • node-red
  • http
  • request
  • fetch

Maintainers