查询命令结果

根据命令 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"
  }
}

命令状态

SENT
SUCCESS
FAILED
TIMEOUT

• SENT：命令仍在等待设备最终确认
• SUCCESS：设备已确认执行成功
• FAILED：命令未成功完成
• TIMEOUT：在等待窗口内没有拿到最终确认，应按未确认成功处理

轮询建议

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

响应 data 结构

字段	类型	必填	说明
id	string	是	命令唯一标识，与请求路径中的 commandId 相同
deviceId	string	是	设备唯一标识
relayIndex	integer	是	继电器序号，从 1 开始
action	string	是	命令动作，枚举：ON、OFF、JOG
status	string	是	命令状态，枚举：SENT、SUCCESS、FAILED、TIMEOUT
createdAt	string	是	命令创建时间，RFC3339 UTC

错误响应

可能返回：

• 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