HTTP Receiver

Rather than having an IoT system make requests for external data, a common workflow is to push data from devices within an organization's IoT infrastructure. One way is through HTTP POST requests made to a web server, in this case, ArcGIS Velocity. The HTTP Receiver feed creates a built-in HTTP endpoint that can be used to programmatically send data from IoT devices and applications to Velocity with HTTP POST requests.

Examples

The following are example scenarios when HTTP Post requests are useful:

  • An organization has devices configured to push data to a specified Velocity HTTP endpoint using POST requests.
  • A GIS analyst writes a Python script that processes features and pushes data to a specified Velocity HTTP endpoint using a POST request each time the script runs.

Usage notes

Keep the following in mind when working with HTTP POST requests:

  • Send HTTP POST requests as plain text.
  • The HTTP Receiver feed is configured by the user, including the schema and key fields. Once the feed is created, the URL is available on the feed details page under HTTP Endpoint Path. This is the URL to which data can be pushed using an HTTP POST request.
  • Set the Authentication type parameter to ArcGIS to use OAuth 2.0 authentication. Each incoming message must include a valid token for the owner of the feed. Messages without a valid token will be rejected.
  • After configuring the feed connection parameters, see Configure input data to learn how to define the schema and the key fields.

Parameters

The following table lists the feed connection parameters:

ParameterExplanationData Type

HTTP Endpoint Path

The full URL to use to send messages.

The URL is generated and populated by Velocity after the feed is started.

String

Authentication type

Specifies the authentication type for incoming messages. Options are None and ArcGIS. If None is specified, no authentication is performed. If ArcGIS is specified, each incoming message must include a valid token for the owner of the feed. Messages without a valid token will be rejected.

The token must be in the request headers as Authorization: Bearer <your token>.

String

Additional logging

Optionally enable logging for raw HTTP requests and responses issued by Velocity.

Note:

This parameter should only be enabled for troubleshooting purposes and disabled when troubleshooting is complete. Once enabled, start the feed and the debug level logs will be available on the feed logs page. If necessary, contact Esri Technical Support for assistance with troubleshooting.

Boolean