上报设备固件升级结果

POST

https://qyapi.weixin.qq.com/cgi-bin/openhw/device/report_firmware_upgrade_result

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

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/openhw/device/report_firmware_upgrade_result' \
--header 'Content-Type: application/json' \
--data-raw '{
	"oper_id":"OPER_ID",
	"errcode":1,
	"errmsg":"设备离线",
	"cur_version":"CUR_VERSION"
}'

响应示例

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

请求参数

Query 参数

device_access_token

string

可选

device_access_token ,获取方式见获取设备调用凭证

示例值:

DEVICE_ACCESS_TOKEN

Body 参数application/json

oper_id

string

必需

固件升级事件中携带的操作id

errcode

integer

必需

固件升级结果，0-升级成功，1-设备离线，其他失败-厂商自定义

errmsg

string

可选

固件升级结果描述，升级失败时请简短描述失败原因

cur_version

string

设备当前固件版本

必需

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

错误码

必需

errmsg

string

错误码描述

必需

修改于 2022-12-08 06:43:01

获取设备中指定成员的信息

回调协议相关