HTTP

Easily ingest data to Streamfold over HTTP.

The HTTP source allows you to ingest data to Streamfold with HTTP POST requests. Request payloads are converted to events internally and can be transformed or routed to any destination.

Overview

Adding an HTTP source to your Streamfold topology allows you to accept HTTP POST requests at /streamfold/http on your ingress endpoint. Each request will be converted to an event and sent to any stream attached to the HTTP source. The source accepts data in either JSON or NDJSON format with optional compression.

Configuration

Use the following details to send HTTP POSTs to your Streamfold account once you add an HTTP source:

• POST URL: https://ingress.streamfold.com/streamfold/http
• Basic auth: streamfold:<sf-ingress-token>

Replace the correct ingress endpoint and <sf-ingress-token> available in the Source configuration instructions in the application. Learn more

Supported formats

Content types

Streamfold accepts the following content types. Unsupported content types will result in a 400 response code.

Content-Type: application/json

The entire POST request body will be decoded from JSON and passed along as a single Streamfold event.

Content-Type: application/x-ndjson

Each newline will be decoded as JSON and passed along as a single Streamfold event.

Content encodings

You can optionally encode request bodies with the following content encoding types.

Content-Encoding: gzip

Request body will be decompressed with gzip.

Content-Encoding: deflate

Request body will be decompressed with zlib.

Notes

A null value in JSON is represented as a nil in the Streamfold Expression Language.