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.

https://data-gateway.akenza.io/v3/capture?secret={uplinkSecret}&deviceId={deviceId}
The body can be any JSON object.
Request
Response
Request
Headers
Content-Type
required
string
application/json
Query Parameters
timestamp
optional
string
The timestamp of the event (ISO-8601 formatted - the current time will be used if not provided)
topic
optional
string
The data topic ("default" will be used if not provided)
uplinkSecret
required
string
The uplink secret used to authenticate the request
deviceId
required
string
The device ID
Response
200: OK
{
"id": "UUID",
"timestamp": "ISO-8601 date string",
"message": "uplink received"
}

‚Äč