Skip to content

功能概述 ​

获取硬件设备详情列表接口

  • 获取硬件设备详情列表接口

接口访问 ​

接口地址 ​

system/manage/device/list

请求方式 Method ​

GET

Header - Authorization Type : Bearer Token ​

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

请求参数 ​

属性类型长度必填默认值说明
isOnlineint64false-1设备是否在线,0否,1是
hardwareTypeint64true0设备类型,1-门锁 2-电表 3-水表
propertyNamestring256false""所属物业名称
houseNamestring256false""所属房产名称
pageint64false1页码
pageSizeint64false20页面大小

请求示例 ​

{
    "isOnline":0,
    "hardwareType":3,
    "propertyName":"",
    "houseName":"",
    "page":1,
    "pageSize":20
}

返回值 ​

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

返回示例 ​

{
    "response": {
        "list": [
            {
                "deviceID": 1,
                "status": 0,
                "alias": "水表设备",
                "waterModel": "",
                "gatewayID": 6,
                "isOnline": 0,
                "isClose": 1,
                "bindTime": "0000-00-00 00:00:00",
                "activationTime": "0000-00-00 00:00:00",
                "lastOnlineTime": "0000-00-00 00:00:00",
                "createTime": "2025-11-03 16:29:19"
            }
        ],
        "pagination": {
            "total": 1,
            "page": 1,
            "page_size": 20,
            "total_page": 1
        }
    },
    "requestId": "e9523bf8-45e7-47ce-9055-440be1809da5"
}

错误码 ​

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