设置继电器点动时长

设置指定继电器的点动持续时长。后续 JOG 操作使用设备保存的该配置。

端点与权限

PUT /wlte/v1/devices/{deviceId}/relays/{index}/jog-config

需要 device:config。

请求

PUT {baseUrl}/wlte/v1/devices/{deviceId}/relays/{index}/jog-config
Authorization: Bearer {accessToken}
Content-Type: application/json
Idempotency-Key: <调用方生成的唯一字符串>

{
  "durationSec": 2
}

参数	类型	规则
index	integer	路径参数，继电器序号，从 1 开始
durationSec	integer	请求体字段，范围 1 到 8000 秒

成功响应

{
  "code": "COMMAND_ACCEPTED",
  "message": "Command accepted.",
  "requestId": "req_001",
  "data": {
    "command": {
      "id": "cmd_001",
      "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"
    }
  }
}

HTTP 状态码为 202 Accepted。params 是请求值；只有设备确认成功时才返回 result。TIMEOUT 时不返回 result。

配置修改不会通过 WebSocket 广播。需要确认每路继电器当前点动时长时，调用 查询设备配置。

新的配置操作使用新 Idempotency-Key；重试同一操作时复用原 key。使用 data.command.id 调用 查询命令结果。

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