Logging Sensor Data

In this tutorial, we will cover the steps to POST your sensor data via the Leftover Labs API so you can visualise them and collect them in a graph.

If you haven’t set up your account and created a Graph and Dataset yet, you can do so by following this guide here.

API Endpoint [API Docs]

The Leftover Labs API endpoint to post sensor data is:

https://api.leftoverlabs.com/graph/data/create/

Required Headers

Ensure you include the following headers in your POST request:

  • Content-Type: application/json
  • api-key: YOUR_API_CREDENTIALS_KEY
  • dataset-id: YOUR_DATASET_ID

Request Payload

Your request should include the following JSON payload:

        
{
    "sensor_value": "10"
}
        
    

You can also include an optional timestamp to specify when the data was collected. If not provided, the current time will be used.

        
{
    "sensor_value": "10",
    "timestamp": "2023-07-15T14:30:00Z"
}
        
    

Timestamp Format

The timestamp should be in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ

Format Components:

  • YYYY: Four-digit year
  • MM: Two-digit month
  • DD: Two-digit day
  • T: Separator between date and time
  • HH: Two-digit hour (24-hour format)
  • MM: Two-digit minute
  • SS: Two-digit second
  • Z: UTC timezone indicator

Example Implementation

Here is an example Python code snippet to help you POST your sensor data:

Co funded by the EU

Funded by the European Union. Views and opinions expressed are however those of the author(s) only and do not necessarily reflect those of the European Union or the European Education and Culture Executive Agency (EACEA). Neither the European Union nor EACEA can be held responsible for them.

Project Number: 2023-3-CY02-KA210-YOU-000173087