Cloud Services API ReferenceSmart HomeSmart Home Basic ServiceHome ManagementQuery Room Device

Query family room equipment

Last Updated on : 2023-06-20 15:36:08download

Used to query the equipment in the family room.

API address

GET: /v1.0/homes/{home_id}/rooms/{room_id}/devices

Request parameter

Parameter name	Type	IN	Required	Description
home_id	Long	uri	true	Family ID
room_id	Long	uri	true	Room ID

Return parameter

Parameter name	Type	Description
result	List	Return parameter description

Description of result

Parameter name	Type	Description
id	String	Device ID
uuid	String	Unique Device ID
uid	String	User ID
biz_type	Integer	Apply bizType
name	String	Device Name
time_zone	String	Time Zone
ip	String	Device IP
local_key	String	Key
sub	Boolean	Determine whether it is a sub-device true: yes false: no
model	String	Product Model
create_time	Long	The time when the device was first allocated to the network, expressed as a 10-digit timestamp
update_time	Long	The device status update time, expressed by a 10-digit timestamp
active_time	Long	The last time the device was networked, expressed as a 10-digit timestamp
status	List	Device function status
owner_id	String	Device Owner ID
product_id	String	Product ID
product_name	String	Product Name
category	String	Product Category
icon	String	Device Icon
online	Boolean	Determine whether the device is online true: online false: not online
node_id	String	Determine whether there is a sub-device. true: there is a sub-device false: there is no sub-device

Description of status

Parameter name	Type	Description
code	String	Function code
value	Object	Function Value

Request example

GET: /v1.0/homes/31****/rooms/234****/devices

{}

Return example

{
    "result": [
        {
            "sub": false,
            "create_time": 1601276997,
            "local_key": "023b0565cafb****",
            "owner_id": "2567****",
            "biz_type": 116030,
            "ip": "",
            "icon": "smart/icon/ay1536722.png",
            "time_zone": "",
            "product_name": "wifi test 1.2",
            "uuid": "vdevo16012769974****",
            "active_time": 1601276997,
            "uid": "ay1555492511130R****",
            "update_time": 1601276997,
            "product_id": "afctjpmhjvxr****",
            "name": "wifi test 1.2-vdevo",
            "online": true,
            "id": "vdevo16012769974****",
            "category": "dj",
            "status": [
                {
                    "code": "switch_led",
                    "value": "false"
                }
            ]
        }
    ],
    "t": 1603804495501,
    "success": true
}

Error code

For more information, see error code.

Prev DocModify Room Name

Next DocQuery User Home List