Connector types supported

To ensure easy integration of UnaConnect within the Client’s infrastructure,UnaConnect offers different types of Connectors. Both low-level protocols and dedicated solutions are supported. A simple form allows a user with sufficient permission to create a new connector.
By offering the open-standard protocols HTTPS, MQTT, and UDP, UnaConnect is natively compliant with most of the IoT dashboards and solutions on the market.
To simplify the integration of the messages into various solutions such as IoT dashboards, UnaConnect also includes custom-made Connectors:
  • Splunk
  • AWS IoT
  • More will be added in the future such as Microsoft PowerBI.

The HTTP/HTTPS Connector has several elements customizable:
  • Headers: the header of the request. It allows you to add Authorization header, an api-key or any headers.
  • Method: by default, UnaConnect will do a "POST". "GET" is also supported.
  • Url: the destination used to send the data.
  • Body: define a specific format for your body
  • Url Query String or Url Search Params: To enter as a JSON, parameters will be added to the URL (example: &device=12345&timestamp=123124)
We advise our users to define the following parameters :
URL: YOUR_URL.com/endpoint
Headers: {"Authorization":"ABCDEF1233456789"}
Format: JSON
URL Query String: {"deviceId":"{deviceId}","timestamp":{timestamp}}
Body: {"deviceId":"{deviceId}","deviceType":"{deviceType}","deviceName":"{deviceName}","groupId":"{groupId}","dataType":"{dataType}","data":{data},"timestamp":{timestamp}}
You will receive the data as:
POST https://YOUR_URL.com/endpoint?deviceId=DEVICE_ID×tamp=1621925764
Content-Type='application/json'&
Authorization=ABCDEF1233456789

Content-Type: application/json
{
  "deviceId": "sigfox-DEVICE_ID",
  "deviceType": "unasenseV1",
  "deviceName": "UnaBiz's Meeting Room A - UnaSense",
  "groupId": "1234567890987654321",
  "dataType": "DATA",
  "data": {
    "mode": "timer",
    "temperature": 27.52,
    "humidity": 62.62
  },
  "timestamp": 1621925764
}

Each of these elements can integrate variables. To use them, they must follow the format: {variable}. For example, if the connector is linked to an UnaSense device, {temperature} will be replaced by the current temperature.
⚠️ The variables must be a string.
The following variables are always available :
  • {deviceId}
  • {timestamp}
  • {deviceName}
  • {groupId}
  • {dataType}
  • {deviceType}
  • {data} All the decoded data as an object.
  • {configuration} The configuration of the device when UunaConnect received the message
  • {information} All the extra informationas an object.
If available in the message and according to the data type, you can receive:
Data Type = DATA
  • {mode} IF AVAILABLE
  • {temperature} IF AVAILABLE
  • {humidity} IF AVAILABLE
  • {motionCount} IF AVAILABLE
Data Type = GEOLOC
  • {radius}
  • {lat}
  • {lng}
  • {lastLocation}