获取设备信息

更新时间：2023-06-28 08:16:40下载pdf

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

接口描述

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

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	设备 ID。

返回参数

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

result 说明

参数名	类型	说明
id	String	设备 ID。
gateway_id	String	网关 ID, 非网关子设备时为空。
node_id	String	节点 ID, 非网关子设备时为空。
uuid	String	设备 UUID。
category	String	产品品类。
category_name	String	产品品类名称。
name	String	设备名称。
product_id	String	产品 ID。
product_name	String	产品名称。
local_key	String	密钥。
sub	Boolean	是否为子设备。
asset_id	String	资产 ID。
owner_id	String	家庭 ID。
ip	String	设备 IP。
lon	String	经度。
lat	String	纬度。
model	String	产品型号。
time_zone	String	时区。
active_time	Long	激活时间。
update_time	Long	更新时间。
create_time	Long	初次配网时间。
online	Boolean	在线状态。
icon	String	设备图标。
sn	String	设备的序列号。

请求示例

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
}

错误码

参考错误码。