设置继电器点动时长

通过 device.operation.execute 设置指定继电器的点动持续时长。

权限

device:config

Request

{
  "type": "request",
  "requestId": "req_jog_config_001",
  "topic": "device.operation.execute",
  "data": {
    "deviceId": "abc123456789",
    "idempotencyKey": "idem_jog_config_001",
    "operation": {
      "name": "device.relay.jogConfig.set",
      "params": {
        "relayIndex": 1,
        "durationSec": 2
      }
    }
  }
}

字段	类型	必填	说明
relayIndex	integer	是	继电器序号，从 1 开始
durationSec	integer	是	点动时长，范围 1 到 8000 秒

Reply

{
  "type": "reply",
  "requestId": "req_jog_config_001",
  "code": "COMMAND_ACCEPTED",
  "message": "Command accepted.",
  "data": {
    "command": {
      "id": "cmd_01JA...",
      "deviceId": "abc123456789",
      "operation": "device.relay.jogConfig.set",
      "status": "SUCCESS",
      "params": {
        "relayIndex": 1,
        "durationSec": 2
      },
      "result": {
        "relayIndex": 1,
        "durationSec": 2
      },
      "createdAt": "2026-07-15T08:30:00Z"
    }
  }
}

params 是请求值。只有设备确认成功时才返回 result。点动配置变化不会广播 WebSocket 配置事件；如需确认当前配置，调用 REST 查询设备配置。

可能返回 INVALID_REQUEST、AUTH_SCOPE_DENIED、DEVICE_NOT_FOUND、DEVICE_BUSY、DEVICE_OFFLINE、IDEMPOTENCY_CONFLICT、COMMAND_REJECTED、RATE_LIMITED、GATEWAY_UNAVAILABLE 或 INTERNAL_ERROR。