智慧硬件开发
智慧硬件开发
硬件云端接入
设备接入
接口调用
上报设备固件升级结果
上报设备固件升级结果
最后更新:2023/03/16

当接口设备状态上报的当前固件版本与可升级固件版本号不相同时,管理员可在企业微信发起固件升级。当管理员选择固件升级后,企业微信云端会触发固件升级回调,硬件厂商在收到回调后,升级设备固件,并通过此接口上报升级结果。升级完成后,请立即上报升级结果,否则影响用户使用体验。

 

请求方式:POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/openhw/device/report_firmware_upgrade_result?device_access_token=DEVICE_ACCESS_TOKEN
请求包体:

{
	"oper_id":"OPER_ID",
	"errcode":1,
	"errmsg":"设备离线",
	"cur_version":"CUR_VERSION"
}

参数说明:

参数名是否必须类型描述
device_access_tokenstringdevice_access_token ,获取方式见获取设备调用凭证
oper_idstring固件升级事件中携带的操作id
errcodeuint32固件升级结果,0-升级成功,1-设备离线,其他失败-厂商自定义
errmsgstring固件升级结果描述,升级失败时请简短描述失败原因
cur_versionstring设备当前固件版本

返回结果:

{
	"errcode": 0,
	"errmsg": "ok"
}

参数说明:

参数名描述
errcode错误码
errmsg错误码描述
errcode非0则必报错升级失败
errcode为0且上报版本号与升级前的版本不一致,才会跳转成功
erccode为0但上报版本号与升级前一直,仍会停留在升级中,这种情况需要检查数据构造是否合理
上一篇获取设备中指定成员的信息
下一篇获取设备管理二维码
    本节内容
硬件直连接入
更新日志
联系我们