本页目录
功能详情
请求地址
最小权限
传入参数说明
样例输入
返回 data 字段说明
样例输出
错误码

刷新封面

刷新封面

功能详情

刷新通道封面。本方法不会出现在 device.capability.list 里。成功 data 为 {}。仅 PaaS 乐橙链路；IoT 托管设备不支持本接口。API 说明见 device.cover.refresh。

请求地址

POST https://openapi.lechange.cn/openapi/v2/device.cover.refresh

最小权限

管理员操作自己绑定的设备不需要权限。操作被分享设备需要基础配置权限。子用户绑定不需要。子账号需要 Config。见 权限码。

传入参数说明

参数名参数类型是否必填默认值合法值参数说明
tokenString是管理员、子用户或子账号 accessToken
deviceIdString是设备序列号
productIdString否可省略。传了且与该设备实际型号不一致 → DV2009
channelIdString是通道号，IPC 常见 "0"。不要传 -1通道号

公共请求字段与签名见 签名约定 与 公共请求负载。

样例输入

{
  "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
  "system": {
    "ver": "1.0",
    "appId": "lcdxxxxxxxxx",
    "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
    "time": 1706511734,
    "nonce": "f5a1ae2d-c09c-4d39-a744-83a5c2c653c2"
  },
  "params": {
    "token": "<yourAccessToken>",
    "deviceId": "TESTIPC000012345",
    "channelId": "0"
  }
}

返回 data 字段说明

无业务字段。成功时 code 为 "0"，data 为 {}。

样例输出

{
  "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
  "result": {
    "code": "0",
    "msg": "Operation is successful",
    "data": {}
  }
}

错误码

本接口可能返回下列码。

网关

错误码错误码说明下一步
SN1001签名异常按 签名 核对 sign
TK1002token 无效或过期重新获取 token
OP1002缺少必填参数补必填字段
OP1003参数不合法按本页参数表核对
OP1039分钟级限流等到下一分钟再试
OP1040调用超限降低频率
DV1007设备离线或超时等设备上线

DV20xx

错误码错误码说明下一步
DV2009productId 与设备实际型号不一致去掉 productId 或改成实际型号
DV2010该设备当前无法通过本接口完成操作省略 productId 再试
DV2011无该能力权限见 权限码
DV2012设备不存在核对序列号
DV2013设备未绑定先绑定

DV21xx

错误码错误码说明下一步
DV2101SDK 未就绪，需重新初始化稍后重试
DV2102设备侧网络断开检查设备网络
DV2103设备未连接平台，请求或事件无法送达等设备上线
DV2104设备侧超时可重试查询类；写操作不要盲目重试
DV2105设备侧内存或资源不足稍后重试
DV2106设备侧报文或协议格式错误核对入参结构
DV2107设备注册或登录失败检查设备状态
DV2108设备鉴权失败核对设备密码 / 安全码
DV2109用户名或密码错误核对密码
DV2110设备因认证失败次数过多已锁定等待解锁
DV2111请求签名、时间戳或防重放校验失败核对签名与时间
DV2112WiFi 参数错误核对 ssid / 密码
DV2113设备身份不匹配（型号 / 序列号）核对序列号与型号
DV2114物联网卡号非法核对卡号
DV2115请求方法或 URL 非法核对路径
DV2116设备不支持该能力或该请求对照 list
DV2117设备侧属性、服务、事件或资源不存在对照 list
DV2118设备侧参数或属性值非法按取值修改
DV2119设备侧未设置处理回调，无法响应稍后重试或换接口
DV2120设备侧属性只读不要写
DV2121已达数量或配置上限先删再建
DV2122目标已存在改名或跳过
DV2123不满足当前操作条件见 msg；休眠设备先唤醒
DV2124对讲忙或呼叫已挂断稍后重试
DV2125低电量拒绝操作充电后再试
DV2126升级失败查 device.upgrade.process
DV2127设备内部错误稍后重试
DV2128设备未初始化完成初始化
DV2129设备已初始化或初始化失败见 msg
DV2130子设备操作失败核对子设备
DV2131子设备不存在核对子设备序列号
DV2132存储介质异常检查 SD / 硬盘
DV2133名称冲突改名
DV2134设备侧权限不足核对权限
DV2199未收录的设备侧错误读响应体 msg 字段
改名
验密