http.md

HTTP/S Input

Fetch data from an HTTP or HTTPS URL using the GET method.

Examples

Fetch every 2 seconds with basic authentication

"inputs": {
	"httpauth": {
		"type": "http",
		"config": {
			"url": "https://jigsaw.w3.org/HTTP/Basic/",
			"interval": 2000,
			"options": {
				"auth": {
					"user": "guest",
					"password": "guest"
				}
			}
		}
	}
}

Fetch data from an HTTPS JSON REST service

"inputs": {
	"httprest": {
		"type": "http",
		"config": {
			"url": "https://jsonplaceholder.typicode.com/todos/1",
			"interval": 2000,
			"options": {},
			"tls": {
				"rejectUnauthorized": false
			}
		}
	}
}

Configuration parameters

• url: HTTP Fetch URL.
• interval: Number of milliseconds to fetch the next data. If not specified, this input behaves as a pull input (data will be fetched when the flow requires it). If set, it behaves as a push input (data will be fetched on an interval basis).
• options: Options passed to the HTTP Client, as described in Request module.
• tls: TLS options as described in NodeJS documentation.
• retry: Number of milliseconds to wait before retrying a failed request. If not specified, retries will not be attempted.

Output

Each HTTP call will generate an object with the following schema:

{
	id: '<input ID>',
	type: 'http',
	url: '<URL>',
	statusCode: '<HTTP status code>',
	headers: '<Response Headers>',
	originalMessage: '<raw data>'
}