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 nameTypeINRequiredDescription
home_idLonguritrueFamily ID
room_idLonguritrueRoom ID

Return parameter

Parameter nameTypeDescription
resultListReturn parameter description

Description of result

Parameter nameTypeDescription
idStringDevice ID
uuidStringUnique Device ID
uidStringUser ID
biz_typeIntegerApply bizType
nameStringDevice Name
time_zoneStringTime Zone
ipStringDevice IP
subBooleanDetermine whether it is a sub-device
  • true: yes
  • false: no
modelStringProduct Model
create_timeLongThe time when the device was first allocated to the network, expressed as a 10-digit timestamp
update_timeLongThe device status update time, expressed by a 10-digit timestamp
active_timeLongThe last time the device was networked, expressed as a 10-digit timestamp
statusListDevice function status
owner_idStringDevice Owner ID
product_idStringProduct ID
product_nameStringProduct Name
categoryStringProduct Category
iconStringDevice Icon
onlineBooleanDetermine whether the device is online
  • true: online
  • false: not online
node_idStringDetermine whether there is a sub-device.
  • true: there is a sub-device
  • false: there is no sub-device

Description of status

Parameter nameTypeDescription
codeStringFunction code
valueObjectFunction 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.