Periodic (e.g., every 30 seconds) report from the charger of online status. The response may include pending commands queued for the device.
Related: for diagnosing connectivity issues such as stale heartbeat or reconnect storms, see the Diagnostic Runbooks.
curl --request POST \
--url https://api.telluspower.example.com/v1/device/heartbeat \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"timestamp": "2025-03-15T10:30:00Z",
"status": "online",
"fault_code": 0
}
'{
"code": 123,
"message": "<string>",
"data": {
"commands": [
{
"command_id": "<string>",
"command": "<string>",
"params": {},
"expiry": "2023-11-07T05:31:56Z"
}
]
}
}Documentation Index
Fetch the complete documentation index at: https://developers.telluspowergroup.com/llms.txt
Use this file to discover all available pages before exploring further.
Charger-side bearer token. Obtained by exchanging device_id and
device_secret (issued at registration) at /v1/device/token.
Valid for 24 hours.
Heartbeat acknowledged. Pending commands may be returned.
Standard response envelope. code is 0 on success and a non-zero
application code on error (see Error Codes — §14).
curl --request POST \
--url https://api.telluspower.example.com/v1/device/heartbeat \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"timestamp": "2025-03-15T10:30:00Z",
"status": "online",
"fault_code": 0
}
'{
"code": 123,
"message": "<string>",
"data": {
"commands": [
{
"command_id": "<string>",
"command": "<string>",
"params": {},
"expiry": "2023-11-07T05:31:56Z"
}
]
}
}