Commands handling

An authenticated Realino-compliant control device can execute authorized requests to get command data from the Realer platform by providing a valid access_token. This command data would be locally used by the connected control device to execute actions in the physical world.

Note: The command data that the connected control device gets refers to the state of actuators as set by users in the control panel on Realer.

Getting control commands from Realer

cURL


              curl "https://www.therealer.com/control_devices/1/commands.realino" \
                -H 'Authorization: Token b11db7f6c816568eb3b156df3aeaa5'

GET /control_devices/{control_device_id}/commands.realino

Retrieve control command data from Realer.

Request headers

Authorization (required)

The authorization token (access_token) to access resources on behalf of the control device. You get this at the time of authentication.

Type: String

Example: Token b11db7f6c816568eb3b156df3aeaa5

Request parameters

control_device_id (required)

ID (id) of control device that needs to access data. You get this at the time of authentication.

Type: Integer

Example: 12345

Responses

Code	Description
200	OK (Success) Example value (application/json) `{ "commands": [ { "id": 1, "value": 0.0, "value_type": "binary", "kind": "relay", "pin_port": "6" }, { "id": 2, "value": 18.5, "value_type": "customary", "kind": "relay", "pin_port": "9" } ] }`
400	Bad Request (Client Error) Example value (application/json) `{ "code": 4004, "error": "The initialization of control device actuators was not successful for the following reasons: the device was not found." }`
401	Unauthorized (Client Error) Example value (application/json) `{ "code": 4001, "error": "The control device must be authenticated: ensure a access token is provided and not expired." }`
403	Forbidden (Client Error) Example value (application/json) `{ "code": 4002, "error": "You can not view the control device for the following reasons: the subscription is not active or expired." }` Example value (application/json) `{ "code": 4029, "error": "You can not view the control device for the following reasons: the maximum number of accesses to the entity in a period has been reached (one access every 5 seconds is the maximum amount allowed)." }`