查询命令结果

根据命令 ID 查询命令的当前执行状态和最终结果。命令 ID 即设备操作响应中的 data.id，平台不提供命令历史列表，调用方应自行持久化。命令记录保留约 48 小时，建议在命令创建后及时查询结果。

端点

GET /wlte/v1/commands/{commandId}

权限要求

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

请求

完整地址：

GET {baseUrl}/wlte/v1/commands/{commandId}

请求头：

Authorization: Bearer {accessToken}
Accept: application/json

路径参数：

参数	类型	必填	规则
commandId	string	是	设备操作响应中的 data.id

成功响应

HTTP 状态码：

200 OK

继电器命令响应：

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "req_001",
  "data": {
    "id": "cmd_001",
    "deviceId": "abc123456789",
    "relayIndex": 1,
    "action": "JOG",
    "status": "SUCCESS",
    "createdAt": "2026-04-29T00:00:00Z"
  }
}

RS485 透传命令响应：

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "req_001",
  "data": {
    "id": "cmd_002",
    "deviceId": "rek053537488",
    "type": "RS485_TRANSCEIVE",
    "status": "SUCCESS",
    "result": {
      "responseHex": "02060034000109F7"
    },
    "createdAt": "2026-06-11T00:00:00Z"
  }
}

RS485 超时命令通常不会返回 result：

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "req_001",
  "data": {
    "id": "cmd_002",
    "deviceId": "rek053537488",
    "type": "RS485_TRANSCEIVE",
    "status": "TIMEOUT",
    "createdAt": "2026-06-11T00:00:00Z"
  }
}

RS485 波特率设置命令响应：

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "req_001",
  "data": {
    "id": "cmd_003",
    "deviceId": "rek053537488",
    "type": "RS485_BAUD_RATE_SET",
    "status": "SUCCESS",
    "result": {
      "baudRate": 9600
    },
    "createdAt": "2026-06-11T00:00:00Z"
  }
}

命令状态

SENT
SUCCESS
FAILED
TIMEOUT

• SENT：命令仍在等待设备最终确认。
• SUCCESS：设备已确认执行成功、RS485 已收到从站响应，或 RS485 配置已确认写入。
• FAILED：命令未成功完成。
• TIMEOUT：在等待窗口内没有拿到最终确认，应按未确认成功处理。

轮询建议

• 客户端收到 202 COMMAND_ACCEPTED 后，可轮询该接口。
• 当 data.status 为 SUCCESS、FAILED 或 TIMEOUT 时停止轮询。
• 如果响应为 429 RATE_LIMITED，应等待 Retry-After 后再继续轮询。

通用 data 结构

字段	类型	必填	说明
id	string	是	命令唯一标识，与请求路径中的 commandId 相同
deviceId	string	是	设备唯一标识
status	string	是	命令状态，枚举：SENT、SUCCESS、FAILED、TIMEOUT
createdAt	string	是	命令创建时间，RFC3339 UTC

继电器命令字段

字段	类型	必填	说明
relayIndex	integer	是	继电器序号，从 1 开始
action	string	是	命令动作，枚举：ON、OFF、JOG

RS485 透传命令字段

字段	类型	必填	说明
type	string	是	命令类型，固定为 RS485_TRANSCEIVE
result	object	否	命令结果。超时或失败时可能不存在
result.responseHex	string	否	RS485 从站返回的原始十六进制数据

RS485 波特率设置命令字段

字段	类型	必填	说明
type	string	是	命令类型，固定为 RS485_BAUD_RATE_SET
result	object	否	命令结果。超时或失败时可能不存在
result.baudRate	integer	否	本次写入的 RS485 波特率，单位 bps

错误响应

可能返回：

• 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