HTTP

This page describes HTTP Connectivity in more detail

If a device communicates over HTTP with akenza, an HTTP connector has to be setup and assigned to a data flow.

After creation, a secret is generated which has to be provided in the request. Both the secret and the device ID are set as query params in the HTTP request.

Send an HTTP Uplink

POST https://data-gateway.akenza.io/v3/capture?secret={uplinkSecret}&deviceId={deviceId}

The body can be any JSON object.

Query Parameters

Name	Type	Description
timestamp	string	The timestamp of the event (ISO-8601 formatted - the current time will be used if not provided)
topic	string	The data topic ("default" will be used if not provided)
uplinkSecret	string	The uplink secret used to authenticate the request
deviceId	string	The device ID

Headers

Name	Type	Description
Content-Type	string	application/json

200

{
    "id": "UUID",
    "timestamp": "ISO-8601 date string",
    "message": "uplink received"
}

Array Uplinks

The HTTP connectivity also supports the processing of array uplinks (not just a JSON property which is an array but the whole request body).

There are minimal differences when processing such an uplink in the script.

Refer to the example event for array uplinks in the Scripting section for more details.

Support for using secret and device id in the header

Requests can be submitted by using secret and device id in the header. The key should be secret and device Id. The value of the header is the secret of the device and the device Id value. Both values can be found on the Device Detail Page within API-Configuration or in the device URL.