请求方式:POST
URL: http(s)://ota.heclouds.com/ota/device/version
设备首次升级时需要调用该接口向平台上报版本号。
参数名称 | 格式 | 是否必须 | 说明 |
---|---|---|---|
Content-Type | string | 是 | 必须为application/json |
Authorization | string | 是 | 安全鉴权信息 |
参数名称 | 格式 | 是否必须 | 说明 |
---|---|---|---|
dev_id | string | 是 | 设备id |
参数名称 | 格式 | 是否必须 | 说明 |
---|---|---|---|
f_version | string | 否 | 模组版本号 |
s_version | string | 否 | 应用服务版本号 |
参数名称 | 格式 | 说明 |
---|---|---|
errno | int | 调用错误码,为0表示调用成功 |
error | string | 错误描述,为"succ"表示调用成功 |
1、如果设备需要使用OTA对设备进行升级,需要调用该接口上报设备的当前版本;
2、平台会将对应版本号和设备绑定存储;
3、如果该设备存在升级任务,并且任务的目标版本是此时上报的版本号,那么平台会将该升级任务设定为“已完成”状态。
4、版本号长度限制小于等于20个字符。
POST http://ota/device/version?dev_id=32981907
Authorization:version=2018-10-31&res=products/33704&et=2529385073&method=sha1&sign=RccQWjT1n5OJ2khw3M4aPckkiFs=
Content-Type:application/json
Host: api.heclouds.com
{
"f_version":"1.0", //模组版本号
"s_version":"2.0" //应用软件版本号
}
{
"errno": 0,
"error":“succ”
}