2 Temperature endpoints
Elinus Persson edited this page 2026-05-12 12:11:51 +00:00

Temperature endpoints

GET /temperature/latest/{sensorId}

Path to endpoint

GET /temperature/latest/{sensorId}

Required values

  • sensorId: temperature sensor id

Return values

Returns a JSON object containing temperature data:

  • sensorId: temperature sensor id
  • timestamp: temperature reading timestamp
  • temperature: temperature value

When no error occurs

  • Returns the latest temperature reading for the sensor
  • Status: 200 OK

When error occurs

  • Temperature data not found
  • Status: 404 Not Found

Get /temperature/latest

Path to endpoint

GET /temperature/latest/

Required values

None

Return values

Returns a JSON array of objects of the latest temperature data for each unique sensor. Each item contains the following data:

  • sensorId: temperature sensor id
  • timestamp: temperature reading timestamp
  • temperature: temperature value

When error occurs

  • Temperature data not found
  • Status: 404 Not Found

GET /temperature/all/{sensorId}

Path to endpoint

GET /temperature/all/{sensorId}

Required values

  • sensorId: temperature sensor id

Return values

Returns a JSON array containing temperature data objects:

  • sensorId: temperature sensor id
  • timestamp: temperature reading timestamp
  • temperature: temperature value

When no error occurs

  • Returns all temperature readings for the sensor
  • Status: 200 OK

When error occurs

  • Temperature data not found
  • Status: 404 Not Found

GET /temperature/sensors

Path to endpoint

GET /temperature/sensors

Required values

None

Return values

Returns a JSON array containing available temperature sensors.

When no error occurs

  • Returns all available temperature sensors
  • Status: 200 OK

When error occurs

  • Sensor data not found
  • Status: 404 Not Found

GET /temperature/{year}

Path to endpoint

GET /temperature/{year}

Required values

  • year: year number

Return values

Returns a JSON object containing average temperature data:

  • year: selected year
  • averageTemperature: average temperature value

When no error occurs

  • Returns average temperature data for the selected year
  • Status: 200 OK

When error occurs

  • Temperature data not found
  • Status: 404 Not Found

GET /temperature/{year}/{month}

Path to endpoint

GET /temperature/{year}/{month}

Required values

  • year: year number
  • month: month number

Return values

Returns a JSON object containing average temperature data:

  • year: selected year
  • month: selected month
  • averageTemperature: average temperature value

When no error occurs

  • Returns average temperature data for the selected year and month
  • Status: 200 OK

When error occurs

  • Temperature data not found
  • Status: 404 Not Found