更新设备状态

POST

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

可更新指定设备的在线状态。请及时上报设备状态，建议半小时上报一次，否则会影响用户客户端设备状态的显示与使用。

当设备当前固件与最新固件不相同时，才会在客户端展示固件升级入口，管理员方可升级固件。
可升级固件与固件信息必须同时传输，若有一个参数为空，会忽略另一个参数。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/openhw/device/report_device_status' \
--header 'Content-Type: application/json' \
--data-raw '{
	"online_status":1,
	"cur_version": "CURRENT_FIRMWARE",
	"upgradable_version": "UPGRADEABLE_CURRENT_FIRMWARE",
	"upgradable_version_desc": "重大升级"
}'

响应示例

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

请求参数

Query 参数

device_access_token

string

可选

设备access_token ,获取方式见获取设备型号调用凭证

示例值:

DEVICE_ACCESS_TOKEN

Body 参数application/json

online_status

integer

必需

设备在线状态：1-在线，2-离线

cur_version

string

必需

设备当前固件版本，最长32字节

upgradable_version

string

可选

当前设备可升级的固件版本，最长32字节

upgradable_version_desc

string

可选

当前设备可升级固件信息的简要描述，最长256字节

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

错误码

必需

errmsg

string

错误码描述

必需

修改于 2022-12-08 06:20:29