获取设备信息

更新时间:2023-06-28 08:12:00下载pdf

本文介绍获取设备信息的 API。

接口描述

根据设备 ID,获取设备信息。

接口地址

GET: /v1.1/iot-03/devices/{device_id}

请求参数

参数名类型参数位置是否必填说明
device_idStringuritrue设备 ID。

返回参数

参数名类型说明
resultBaseDeviceRes返回结果。

result 说明

参数名类型说明
idString设备 ID。
gateway_idString网关 ID, 非网关子设备时为空。
node_idString节点 ID, 非网关子设备时为空。
uuidString设备 UUID。
categoryString产品品类。
category_nameString产品品类名称。
nameString设备名称。
product_idString产品 ID。
product_nameString产品名称。
local_keyString密钥。
subBoolean是否为子设备。
asset_idString资产 ID。
owner_idString家庭 ID。
ipString设备 IP。
lonString经度。
latString纬度。
modelString产品型号。
time_zoneString时区。
active_timeLong激活时间。
update_timeLong更新时间。
create_timeLong初次配网时间。
onlineBoolean在线状态。
iconString设备图标。
snString设备的序列号。

请求示例

GET: /v1.1/iot-03/devices/xxxxId

返回示例

{
    "result": {
        "result": {
            "sub": false,
            "category_name": "光源",
            "create_time": 1567395627,
            "local_key": "8ab649951d59****",
            "owner_id": "31256829",
            "ip": "124.90.**.***",
            "icon": "smart/icon/1526276264k8q8l44swr2ennf6zx5u92j***.png",
            "lon": "120.0638",
            "time_zone": "+08:00",
            "product_name": "灯",
            "uuid": "38042025cc50e325****",
            "gateway_id": "",
            "active_time": 1620299529,
            "update_time": 1635941286,
            "product_id": "ylr9R01cMWnM****",
            "name": "灯",
            "online": true,
            "model": "LE7",
            "id": "38042025cc50e325****",
            "sn": "693511713****",
            "category": "dj",
            "lat": "30.3027"
        },
        "t": 1635941588278,
        "success": true
    },
    "t": 1635941588278,
    "success": true
}

错误码

参考 错误码