Device status request (status_request)

Last updated on May 17, 2023

Direction: cloud → controller.

Sber Smart Home requests from the agent app installed on the controller the current state of devices. The agent shall respond by sending the following message: sberdevices/v1/<username>/up/status.

Use case example:

1. The user manually changes the state of any devices E.g. turns off a lamp.
2. From time to time, the Smart Home requests from the agent app installed on the controller the current state of the user's devices.
3. The agent receives from the controller the current state of devices, including that of the light. Then it sends the following message: sberdevices/v1/<username>/up/status.
4. Sber Smart Home updates the light state in the Salute app, on SberPortal, SberBox and other devices with Salute assistants.

Message format

Topic:

sberdevices/v1/<username>/down/status_request

Parameter	Type	Mandatory?	Description
username	string	✔︎	Login for connection to the Sber MQTT server (see "Having your controller authorized" for integrators and DIY enthusiasts)

Message body:

Field	Type	Mandatory?	Description
devices	dict<string object>	✔︎	List of devices ID, state of which needs to be returned

{
    "devices": [
        "device1_id": string,
        "device2_id": string,
        "device3_id": string
    ]
}

Message example

The Smart Home requests from the agent app installed on the controller the current state of the socket.

Topic:

sberdevices/v1/1234567/down/status_request

Message body:

{
    "devices": [
        "ABCD_003"
    ]
}