查询命令结果

根据命令 ID 查询当前执行状态和最终结果。平台不提供命令历史列表，调用方应保存设备操作响应中的 data.command.id。命令记录保留约 48 小时。

端点

http

GET /wlte/v1/commands/{commandId}

权限要求

Scope	必须	说明
`device:read`	是	查询命令结果

继电器命令示例

json

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "req_001",
  "data": {
    "id": "cmd_001",
    "deviceId": "abc123456789",
    "operation": "device.relay.set",
    "status": "SUCCESS",
    "params": {
      "relays": [
        { "index": 1, "action": "ON" },
        { "index": 2, "action": "OFF" }
      ]
    },
    "createdAt": "2026-07-15T08:30:00Z"
  }
}

RS485 命令示例

json

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "req_002",
  "data": {
    "id": "cmd_002",
    "deviceId": "rek053537488",
    "operation": "device.rs485.transceive",
    "status": "SUCCESS",
    "params": {
      "requestHex": "02060034000109F7"
    },
    "result": {
      "responseHex": "02060034000109F7"
    },
    "createdAt": "2026-07-15T08:30:00Z"
  }
}

TIMEOUT 时 result 通常不存在。

通用命令结构

字段	类型	必填	说明
`id`	string	是	命令 ID
`deviceId`	string	是	设备标识
`operation`	string	是	公开操作名
`status`	string	是	`SENT`、`SUCCESS`、`FAILED` 或 `TIMEOUT`
`params`	object	否	规范化后的请求参数
`result`	object	否	设备确认结果；超时或失败时可能不存在
`createdAt`	string	是	命令创建时间，RFC3339 UTC

operation 当前可能为：

device.relay.set
device.rs485.transceive
device.rs485.baudRate.set
device.relay.jogConfig.set

轮询建议

初始响应为 SENT 时再轮询本接口。
SUCCESS、FAILED 和 TIMEOUT 都是终态。
收到 429 RATE_LIMITED 时，等待 Retry-After 后再查询。
不要在已收到终态后继续轮询。

可能返回 400 INVALID_REQUEST、401 AUTH_REQUIRED、401 AUTH_INVALID、401 AUTH_EXPIRED、403 AUTH_SCOPE_DENIED、404 COMMAND_NOT_FOUND、429 RATE_LIMITED 或 500 INTERNAL_ERROR。

查询命令结果 ​

端点 ​

权限要求 ​

继电器命令示例 ​

RS485 命令示例 ​

通用命令结构 ​

轮询建议 ​