查询设备配置

查询单台设备最近一次已缓存的运行配置，例如继电器点动时长和 RS485 波特率。

该接口不会主动刷新设备，也不会向设备下发任何命令。配置数据来自设备最近一次全量刷新、配置读取或配置写入确认后的缓存；如果设备尚未上报某类配置，对应字段会省略。

端点

GET /wlte/v1/devices/{deviceId}/config

权限要求

Scope	必须	说明
device:read	是	读取目标设备的已缓存配置

请求

完整地址：

GET {baseUrl}/wlte/v1/devices/{deviceId}/config

请求头：

Authorization: Bearer {accessToken}
Accept: application/json

路径参数：

参数	类型	必填	规则
deviceId	string	是	不能为空

成功响应

HTTP 状态码：

200 OK

响应体：

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "req_001",
  "data": {
    "deviceId": "rek053537488",
    "relay": {
      "channels": [
        {
          "index": 1,
          "jogTimeSeconds": 1
        },
        {
          "index": 2,
          "jogTimeSeconds": 1.5
        }
      ]
    },
    "rs485": {
      "baudRate": 9600
    },
    "updatedAt": "2026-06-12T08:30:00Z"
  }
}

如果设备存在但暂无可用配置，relay、rs485 和 updatedAt 可能不存在：

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "req_001",
  "data": {
    "deviceId": "rek053537488"
  }
}

响应 data 结构

字段	类型	必填	说明
deviceId	string	是	设备唯一标识
relay	object	否	继电器配置
relay.channels	array<RelayChannelConfig>	否	每路继电器配置
relay.channels[].index	integer	是	继电器序号，从 1 开始
relay.channels[].jogTimeSeconds	number	是	点动时长，单位秒
rs485	object	否	RS485 配置
rs485.baudRate	integer	否	RS485 波特率，单位 bps
updatedAt	string	否	配置缓存更新时间，RFC3339 UTC

返回规则

• 本接口只读取缓存，不触发设备刷新
• 设备离线时仍可返回最后一次缓存配置
• 配置字段按设备能力和上报情况返回；未上报的字段会省略
• 修改配置后，可通过本接口读取服务端已缓存的配置值

错误响应

可能返回：

• 400 INVALID_REQUEST
• 401 AUTH_REQUIRED
• 401 AUTH_INVALID
• 401 AUTH_EXPIRED
• 403 AUTH_SCOPE_DENIED
• 404 DEVICE_NOT_FOUND
• 429 RATE_LIMITED
• 500 INTERNAL_ERROR