查询设备状态

通过 WebSocket 长连接查询指定设备的当前设备状态。

Topic

device.status.get

权限

需要：

device:read

Request

{
  "type": "request",
  "requestId": "req_status_001",
  "topic": "device.status.get",
  "data": {
    "deviceId": "abc123456789"
  }
}

请求 data 结构

字段	类型	必填	说明
deviceId	string	是	设备唯一标识

Reply

{
  "type": "reply",
  "requestId": "req_status_001",
  "topic": "device.status.get",
  "success": true,
  "data": {
    "deviceId": "abc123456789",
    "name": "YourDeviceName",
    "deviceType": "SM4_T_TH",
    "status": "ONLINE",
    "peripherals": {
      "relays": [
        {
          "index": 1,
          "on": false
        },
        {
          "index": 2,
          "on": false
        },
        {
          "index": 3,
          "on": true
        },
        {
          "index": 4,
          "on": false
        }
      ],
      "digitalInputs": [
        {
          "index": 1,
          "active": false
        },
        {
          "index": 2,
          "active": false
        },
        {
          "index": 3,
          "active": false
        },
        {
          "index": 4,
          "active": false
        }
      ],
      "sensors": [
        {
          "index": 1,
          "type": "TEMP",
          "value": 30.4,
          "unit": "C",
          "status": "ONLINE"
        },
        {
          "index": 2,
          "type": "TEMP",
          "value": 32.6,
          "unit": "C",
          "status": "ONLINE"
        },
        {
          "index": 2,
          "type": "HUMI",
          "value": 54,
          "unit": "%",
          "status": "ONLINE"
        }
      ]
    },
    "stateUpdatedAt": "2026-04-03T00:41:44Z"
  }
}

规则

• data 直接复用 REST 查询设备详情 中的 Device 结构
• stateUpdatedAt 使用 RFC3339 UTC
• peripherals 是设备当前外设状态数据，客户端应按整块替换处理

错误

可能返回：

• INVALID_REQUEST
• AUTH_SCOPE_DENIED
• DEVICE_NOT_FOUND
• RATE_LIMITED
• INTERNAL_ERROR