获取设备详情

更新时间：2023-12-07 03:33:54下载pdf

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

接口描述

您可以通过本 API 查询设备的详情信息，包括设备属性和设备最新状态。

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
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****

返回示例

{
    "sub": false,
    "create_time": 1560827137,
    "local_key": "3a9b50126fe473****",
    "owner_id": "1070****",
    "biz_type": 299009,
    "ip": "120.198.****.****",
    "icon": "smart/icon/15402589135gknz23xajb_0.png",
    "time_zone": "+08:00",
    "product_name": "Wifi scales_OEM",
    "uuid": "60613135b23cddc294****",
    "active_time": 1589505938,
    "uid": "ay157896239864843g****",
    "update_time": 1589764585,
    "product_id": "g0er6hSKgMqr****",
    "name": "体脂秤",
    "online": true,
    "id": "60613135b121cddc294****",
    "category": "qt",
    "status": [
        {
            "code": "weight",
            "value": "48900"
        },
        {
            "code": "left_hand_r",
            "value": "0"
        },
        {
            "code": "right_hand_r",
            "value": "0"
        },
        {
            "code": "left_leg_r",
            "value": "0"
        },
        {
            "code": "right_leg_r",
            "value": "0"
        },
        {
            "code": "body_r",
            "value": "653"
        },
        {
            "code": "battery_low",
            "value": "false"
        }
    ]
}

错误码

参考错误码。