设置继电器点动时长

即将推出

此接口在当前版本暂不可用，将在后续版本中开放。

设置指定设备指定继电器的点动（JOG）持续时长。时长持久化存储在设备中，后续所有点动命令均使用此配置。

端点

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

权限要求

Scope	必须	说明
device:config	是	设置指定继电器的点动时长

请求

完整地址：

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

请求头：

Authorization: Bearer {accessToken}
Content-Type: application/json
Accept: application/json

路径参数：

参数	类型	必填	规则
deviceId	string	是	不能为空
index	integer	是	正整数，从 1 开始

请求体：

{
  "durationSec": 2
}

字段规则：

字段	类型	必填	规则
durationSec	integer	是	正整数

当前阶段说明

• 当前 MVP 只要求 durationSec 为正整数
• 当前 MVP 不在 device profile 中返回 JOG 时长的 min/max 范围
• 如果设备或设备类型不支持点动配置，服务端会返回 422 COMMAND_REJECTED

成功响应

HTTP 状态码：

200 OK

响应体：

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "req_001",
  "data": {
    "deviceId": "abc123456789",
    "relayIndex": 1,
    "durationSec": 2
  }
}

响应 data 结构

字段	类型	必填	说明
deviceId	string	是	设备唯一标识
relayIndex	integer	是	继电器序号，从 1 开始
durationSec	integer	是	已写入设备的点动时长，单位为秒

错误响应

可能返回：

• 400 INVALID_REQUEST：durationSec 缺失、非正整数，或包含未知字段
• 401 AUTH_REQUIRED
• 401 AUTH_INVALID
• 401 AUTH_EXPIRED
• 403 AUTH_SCOPE_DENIED
• 404 DEVICE_NOT_FOUND
• 422 COMMAND_REJECTED
• 429 RATE_LIMITED
• 500 INTERNAL_ERROR