Device Telemetry

This section of the Device API describes how to retrieve telemetry data for a specific device.

Get Device Latest Telemetry CloudGateway

GET /v3/sites/{site_id}/devices/{device_id}/telemetry

Returns the latest values of device's specified telemetry attributes.

Request

$ curl 'http://api.enapter.com/v3/sites/fecbbba0-79f2-4e9e-a6f0-69a310ab110b/devices/123e4567-e89b-12d3-a456-426614174000/telemetry?attribute.in=voltage,uptime' \
  -H 'X-Enapter-Auth-Token: {ACCESS_TOKEN}'

Query Parameters

attribute.inarray of strings

List of device telemetry attributes separated by commas.

relevance_intervalduration string

Time window during which a telemetry value should be considered valid or up to date. It is set to 30 seconds by default.

Response

{
  "telemetry": {
    "voltage": {
      "value": 12,
      "timestamp": 1662593249
    },
    "uptime": {
      "value": 12345,
      "timestamp": 1662593249
    }
  }
}