Device status request (status_request)

Last updated on December 22, 2024

Direction: cloud → client.

Sber Smart Home requests from the agent app 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 assistant.

Message format

Topic:

sberdevices/v1/<username>/down/status_request

Parameter	Type	Mandatory?	Description
username	string	✔︎	Login for connection to the Sber MQTT server (see [Getting data for connecting an agent to the cloud](/en/smarthome/mqtt-diy/agent-authorization) section)

Message body:

Field	Type	Mandatory?	Description
devices	list<string>	✔︎	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"
    ]
}