Data Forwarding Service

The collected data from the sensors will be sent to Vicotee Cloud, https://cloud.vicotee.com, there you can process and view the data. You can forward the data to your own cloud with following services:

  • Data Forwarding, a service to POST data to your own server.
  • Workspace Data Forwarding, create workspace and setup data forwarding for the space.
  • IFEC, a service to email data.
  • API to fetch data from Vicotee Cloud to your server.

Data Forwarding Service

This service allow you to forward data to your cloud service. The data will be a POST with application/json or text/pain as Content-type.

A secret phrase can be used for signing the payload with hex digest of HMAC-SHA256 and send with HTTP header as X-Vicotee-Signature. To verify the data is from Vicotee Cloud, you can use your secret phrase and calculate the digest of HMAC-SHA256 of the payload and compare the result with the one in X-Vicotee-Signature.

 You can only forward data from your own sensors. Sensors shared with you by other users will not be forwarded.

1. Login to Vicotee Cloud, https://cloud.vicotee.com and install the Data Forwarding app. (Click here to read how to install Cloud App)

Install Data Forwarding app

2. Once the Data Forwarding app is installed, you can configure how data will be sent to your cloud.

Configurable attributes of Data Forwarding app
Field Description
Payload URL URL of your service where data can be posted to.
Content type You can choose between application/json or text/plain.
Headers Add custom HTTP headers.
Enabled You can disable the data forwarding.
Body

Anything you enter in here will be payload to be sent to your server. Example of a payload is:

{
   "deviceId" : "{uuid}",
   "deviceName" : "{name}",
   "sensor" : "{key}",
   "value" : {val},
   "unit" : "{unit}"
}

 

With the Body template shown above, and if device ID is 1234-5, the sensor is 'humidity' and measurement value is 69 RH, then you will receive a payload that looks this:

{
   "deviceId" : "1234-5",
   "deviceName" : "Test Device, 2nd floor.",
   "sensor" : "humidity",
   "value" : 69.0,
   "unit" : "RH"
}

NOTE: value is a double, while all other attributes are strings.