获取设备详情

更新时间：2024-01-11 06:00:07下载pdf

本文介绍获取设备详情的 API。

接口描述

根据设备 ID，查询设备的详情信息，包括设备属性和设备最新状态。

接口地址

GET: /v1.0/devices/{deviceId}

请求参数

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

返回参数

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

result 说明

参数名	类型	说明
id	String	设备 ID
uuid	String	设备标识
uid	String	用户 ID
biz_type	Integer	应用类型
name	String	设备名称
time_zone	String	时区
ip	String	设备 IP 地址
local_key	String	密钥
sub	Boolean	是否为子设备。 `true`：是 `false`：不是
model	String	产品型号
create_time	Long	设备初次配网时间
update_time	Long	设备状态更新时间
active_time	Long	设备上次配网时间
status	List	设备功能状态
owner_id	String	设备拥有者 ID
product_id	String	产品 ID
product_name	String	产品名称
category	String	产品类别
icon	String	设备图标
online	Boolean	是否在线。 `true`：在线 `false`：不在线
node_id	String	子设备 ID，当 `sub` 为 `true`，即子设备存在时返回。

status 说明

参数名	类型	说明
code	String	功能点名称
value	Object	功能点对应的取值

请求示例

GET: /v1.0/devices/60613135b121cddc294****

返回示例

{
    "tid": "d8260b1f7d3d11ee82c7664ef4d3e193",
    "result": {
        "sub": true,
        "create_time": 1669898482,
        "local_key": "bf69a****54779",
        "owner_id": "169****15",
        "biz_type": 0,
        "ip": "",
        "icon": "smart/icon/ay15502****4fadc37ee90.png",
        "lon": "120.2961",
        "time_zone": "+08:00",
        "product_name": "手指机器人Plus",
        "uuid": "tuyaac9****4d253",
        "active_time": 1669898482,
        "uid": "ay15913****677KZlj2",
        "update_time": 1699341447,
        "product_id": "yii***zh",
        "name": "手指机器人Plus",
        "online": true,
        "model": "ADFB0301",
        "id": "6cf0ca****ab76bfjntj",
        "category": "szjqr",
        "lat": "30.3663",
        "node_id": "tuyaac9***253",
        "status": [
            {
                "code": "switch",
                "value": true
            },
            {
                "code": "mode",
                "value": "click"
            },
            {
                "code": "arm_down_percent",
                "value": 96
            },
            {
                "code": "click_sustain_time",
                "value": 1
            },
            {
                "code": "battery_percentage",
                "value": 70
            },
            {
                "code": "arm_up_percent",
                "value": 3
            },
            {
                "code": "tap_enable",
                "value": true
            }
        ]
    },
    "t": 1699341506949,
    "success": true
}

错误码

参考错误码。