nsyslog/doc/inputs/http.md

Modular new generation log agent. Reads, transform, aggregate, correlate and send logs from sources to destinations

## HTTP/S Input

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

## Examples

### Fetch every 2 seconds with basic authentication
```json
"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
```json
"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](https://www.npmjs.com/package/request#requestoptions-callback).
* **tls**: TLS options as described in [NodeJS documentation](https://nodejs.org/api/tls.html#tls_tls_createsecurecontext_options).
* **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:
```javascript
{
	id: '<input ID>',
	type: 'http',
	url: '<URL>',
	statusCode: '<HTTP status code>',
	headers: '<Response Headers>',
	originalMessage: '<raw data>'
}
```