简体中文
简体中文
English
联系我们
注册
登录
layout空间导航

获取设备详情

更新时间:2022-04-29 05:33:59下载pdf

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

接口描述

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

接口地址

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

请求参数

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

返回参数

参数名类型说明
resultDeviceRes返回结果

result 说明

参数名类型说明
idString设备 ID
uuidString设备标识
uidString用户 ID
biz_typeInteger应用类型
nameString设备名称
time_zoneString时区
ipString设备 IP
local_keyString密钥
subBoolean是否为子设备:
  • true:是
  • false:不是
modelString产品型号
create_timeLong设备初次配网时间
update_timeLong设备状态更新时间
active_timeLong设备上次配网时间
statusList设备功能状态
owner_idString设备拥有者 ID
product_idString产品ID
product_nameString产品名
categoryString产品类别
iconString设备图标
onlineBoolean是否在线:
  • true:在线
  • false:不在线
node_idString子设备 ID,当 sub 为 true,即子设备存在时返回。

status 说明

参数名类型说明
codeString功能点名称
valueObject功能点对应的取值

请求示例

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"
        }
    ]
}

错误码

参考 错误码