Sending Data*

*Hang tight — we're still working on it!

Overview

HTTPs

By default, devices in Valeiot support HTTPs protocols out of the box. Follow the steps below to send data using HTTPs.

tip

The API docs is an essential reference to use alongside these instructions.

HTTPs via Data Source Token

This method allows you to add data points to a data source (device or entity) by authenticating with its Data Source Token.

1. Obtain the Data Source Token (e.g. us1:v6MdpTWrvH508Y72o5D4sz3aMWR);
2. In the API docs locate the POST /datasource/datapoints endpoint;
3. Configure your request:
   • Add the Authorization header with the Data Source Token (e.g. Bearer us1:v6MdpTWrvH508Y72o5D4sz3a).
   • Include the data to be inserted into the device in the JSON body.
4. Send the request. If successful, you will receive a confirmation response similar to the example below:

You can also copy and paste the cURL example below into your API management tool. Replace the placeholders (here) with your own values.

curl --request POST \
  --url https://api-here.valeiot.com/api/v1/datasource/datapoints \
  --header 'Authorization: Bearer here' \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "value": "10",
    "variable": "temperature"
  }
]'

5. [EXTRA] If the request does not return a success response, check the following common issues:
   • Authorization header: The token must be prefixed with Bearer . For example: Bearer us1:xxxxx
   • Incorrect host: Ensure the correct host is used. In the example above, the host is us1. You can determine your host from the Data Source Token (e.g., us1:xxxxx).
   • Data format: If your payload does not follow the Valeiot Data Point format, you must configure a Payload Parser to adapt the incoming data before insertion.

HTTPs via Network Token

This method allows you to add data points to a Data Source within a Network (group of Data Sources) authenticating with the Network Token.

1. Obtain the Network Token which the device is within (e.g. us1:R3dEnYKixxc99K25pp4gNcdg0zvL7gzmqvSGm3d6lOR4yxABfSaBFtqVKEY9eW);
2. In the API docs locate the POST /network/datasource/datapoints endpoint;
3. Configure your request:
   • Add the Authorization header with the Network Token (e.g. Bearer us1:v6MdpTWrvH508Y72o5D4sz3a).
   • Add the DNID header
   • Include the data to be inserted into the device in the JSON body.
4. Send the request. If successful, you will receive a confirmation response similar to the example below:

You can also copy and paste the cURL example below into your API management tool. Replace the placeholders (here) with your own values.

curl --request POST \
  --url https://api-here.valeiot.com/api/v1/network/datasource/datapoints \
  --header 'Authorization: Bearer here' \
  --header 'Content-Type: application/json' \
  --header 'DNID: here' \
  --data '[
  {
    "value": "11",
    "variable": "temperature"
  }
]'

5. [EXTRA] If the request does not return a success response, check the following common issues:

   • Authorization header: The token must be prefixed with Bearer . For example: Bearer us1:xxxxx
   • DNID header: The DNID must match the DNID defined for the Data Source.
   • Incorrect host: Ensure the correct host is used. In the example above, the host is us1. You can determine your host from the Device Token (e.g., us1:xxxxx).
   • Data format: If your payload does not follow the Valeiot Data Point format, you must configure a Payload Parser to adapt the incoming data before insertion.

MQTT

By default, devices in Valeiot support MQTT protocols out of the box. Follow the steps below to send data using MQTT.

MQTT via Device Token

1. *Hang tight — we're still working on it!

MQTT via Network Token

1. *Hang tight — we're still working on it!

Other Communication Protocol

If your use case requires integration with a different communication protocol, you will need to implement Middleware to bridge the gap. For detailed guidance on integrating devices with custom protocols, check out the guide here.