Skip to main content
GET
/
device
/
commands
Fetch pending command (long polling)
curl --request GET \
  --url https://api.telluspower.example.com/v1/device/commands \
  --header 'Authorization: Bearer <token>'
{
  "code": 123,
  "message": "<string>",
  "data": {
    "command_id": "<string>",
    "command": "<string>",
    "params": {},
    "expiry": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

Charger-side bearer token. Obtained by exchanging device_id and device_secret (issued at registration) at /v1/device/token. Valid for 24 hours.

Query Parameters

​
connector_id
integer
required
Required range: x >= 1
​
wait
integer
default:30

Maximum wait time in seconds.

Required range: 1 <= x <= 60

Response

200 - application/json

Command available, or no command (timeout).

Standard response envelope. code is 0 on success and a non-zero application code on error (see Error Codes — §14).

​
code
integer
required

0 = success; otherwise an error code per the Error Codes section.

​
message
string
required

Human-readable description.

​
data
object | null

Endpoint-specific payload.