Appearance
功能概述
获取硬件设备详情接口
- 获取硬件设备详情接口
接口访问
接口地址
system/manage/device/detail
请求方式 Method
GET
Header - Authorization Type : Bearer Token
| 属性 | 类型 | 长度 | 必填 | 默认值 | 说明 | 访问版本 |
|---|---|---|---|---|---|---|
| token | string | 32 | true | 用户身份标识令牌 | - |
请求参数
| 属性 | 类型 | 长度 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
| hardwareID | int | 64 | true | 0 | 设备ID |
| hardwareType | int | 64 | true | 0 | 设备类型,1-门锁 2-电表 3-水表 |
请求示例
{
"hardwareID":2,
"hardwareType":3
}返回值
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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": {
"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不能为空 | 检查传入参数 |
| 404 | Fail | 代码报错 |
