功能概述

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

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

接口访问

接口地址

system/manage/device/list

请求方式 Method

GET

Header - Authorization Type : Bearer Token

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

请求参数

属性	类型	长度	必填	默认值	说明
isOnline	int	64	false	-1	设备是否在线，0否，1是
hardwareType	int	64	true	0	设备类型，1-门锁 2-电表 3-水表
propertyName	string	256	false	""	所属物业名称
houseName	string	256	false	""	所属房产名称
page	int	64	false	1	页码
pageSize	int	64	false	20	页面大小

请求示例

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

返回值

属性	类型	必填	说明
deviceNumber	string	true	设备编号
alias	string	true	设备别名
gatewayID	int	true	网关ID
isOnline	int	true	设备是否在线，0-否 1-是
bindTime	string	true	绑定时间
activationTime	string	true	激活时间
lastOnlineTime	string	true	最后在线时间
hardwareType	int	true	设备类型，1-门锁 2-电表 3-水表
hardwareModel	string	true	硬件型号
switchStatus	int	true	硬件开关状态
hardwareID	int	true	硬件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	硬件设备类型错误	检查传入参数
404	Fail	代码报错