修改设备密码

修改指定设备的访问密码。该接口要求设备在线，服务端会等待设备确认后返回结果。

端点

PUT /wlte/v1/devices/{deviceId}/password

权限要求

Scope	必须	说明
device:manage	是	修改设备密码

请求参数

字段	类型	必须	说明
oldPassword	string	是	当前设备密码，必须为 4 个字符
newPassword	string	是	新设备密码，必须为 4 个字符

请求示例

{
  "oldPassword": "1234",
  "newPassword": "5678"
}

响应示例

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "7d2e2e30-36d7-4e31-9e89-c840f54185f8",
  "data": {
    "deviceId": "rek083895063",
    "updated": true
  }
}

常见错误

HTTP 状态码	code	说明
400	INVALID_REQUEST	缺少参数，或密码不是 4 个字符
403	AUTH_SCOPE_DENIED	API Key 未授予 device:manage 权限
404	DEVICE_NOT_FOUND	设备不存在，或当前 API Key 无权访问该设备
409	DEVICE_OFFLINE	设备离线，无法确认修改结果
429	RATE_LIMITED	请求过于频繁，请等待后重试
504	DEVICE_TIMEOUT	设备未在等待时间内确认修改结果

响应不会返回旧密码或新密码。