Last updated
Last updated
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.
POST
https://data-gateway.akenza.io/v3/capture?secret={uplinkSecret}&deviceId={deviceId}
The body can be any JSON object.
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.
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.
Refer to the in the Scripting section for more details.
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
Content-Type
string
application/json
This page describes HTTP Connectivity in more detail