Telemetry & Heartbeats

Technical specifications for real-time monitoring of IoT fuel stations.

API Version

The Heartbeat Protocol

To maintain "Live" status on the partner map, every controller must send a Heartbeat packet every 30 to 60 seconds. Failure to send heartbeats for 3 minutes will mark the station as "Offline" in the customer app.

POST/api/v1/telemetry/heartbeat

Updates the live status of the hardware and connected components.

JSON Payload Specification

JSON

{
  "stationId": "ST_KIN_001",
  "uptime": 86400,
  "wifiSignal": -65,
  "components": [
    { "id": "PUMP_01", "status": "idle", "temp": 32.5 },
    { "id": "PUMP_02", "status": "active", "flow_rate": 1.2 },
    { "id": "TANK_01", "level_percent": 85.0 }
  ],
  "alarms": []
}

Critical Alarm Codes

If an incident occurs, include the corresponding code in the alarms array. This triggers instant notifications to your maintenance team.

ALM_LEAK_DET

Leak detected in distribution line.

ALM_TANK_LOW

Tank level below 10%.

ALM_PUMP_JAM

Mechanical jam detected in pump nozzle.

ALM_PWR_LOSS

Running on backup battery.

Data Analytics

Telemetry data is stored for 90 days. You can access historical charts and efficiency reports via the IoT Insights tab in your dashboard.