Skip to content

功能概述

获取硬件设备详情接口

  • 获取硬件设备详情接口

接口访问

接口地址

system/manage/device/detail

请求方式 Method

GET

Header - Authorization Type : Bearer Token

属性类型长度必填默认值说明访问版本
tokenstring32true用户身份标识令牌-

请求参数

属性类型长度必填默认值说明
hardwareIDint64true0设备ID
hardwareTypeint64true0设备类型,1-门锁 2-电表 3-水表

请求示例

{
    "hardwareID":2,
    "hardwareType":3
}

返回值

属性类型必填说明
deviceNumberstringtrue设备编号
aliasstringtrue设备别名
gatewayIDinttrue网关ID
isOnlineinttrue设备是否在线,0-否 1-是
bindTimestringtrue绑定时间
activationTimestringtrue激活时间
lastOnlineTimestringtrue最后在线时间
hardwareTypeinttrue设备类型,1-门锁 2-电表 3-水表
hardwareModelstringtrue硬件型号
switchStatusinttrue硬件开关状态
hardwareIDinttrue硬件ID

返回示例

{
    "response": {
        "status": 0,
        "deviceNumber": "",
        "alias": "水表新增测试修改啊哈",
        "waterModel": "",
        "gatewayId": 6,
        "isOnline": 1,
        "isClose": 0,
        "bindTime": "2025-11-04 14:43:01",
        "activationTime": "2025-11-04 14:43:01",
        "lastOnlineTime": "2025-11-04 14:43:01",
        "isDelete": 1,
        "createTime": "2025-11-04 14:43:01",
        "modifyTime": "2025-11-04 17:46:39",
        "deleteTime": null,
        "hardwareID": 2
    },
    "requestId": "8696e0e9-e6ed-417e-946f-48864e34434c"
}

错误码

错误码说明解决方案
92001硬件设备类型错误检查传入参数
92002硬件ID不能为空检查传入参数
404Fail代码报错