请求方式:POST
URL: http://ota.heclouds.com/ota/south/device/download/{token}/progress
参数名称 | 格式 | 是否必须 | 说明 |
---|---|---|---|
Content-Type | string | 是 | 必须为application/json |
Authorization | string | 是 | 安全鉴权信息 |
参数名称 | 格式 | 是否必须 | 说明 |
---|---|---|---|
dev_id | long | 是 | 设备id |
参数名称 | 格式 | 是否必须 | 说明 |
---|---|---|---|
step | int | 是 | 取值为[0,100],下载进度比 |
参数名称 | 格式 | 说明 |
---|---|---|
errno | int | 调用错误码,为0表示调用成功 |
error | string | 错误描述,为"succ"表示调用成功 |
1、设备在下载升级包的过程中(分片下载),可以根据需要上报下载进度(设备处于“下载中”,才能上报step=[0,100]);
2、如果设备上报的下载进度为100(即step:100),那么平台会将设备的升级状态从“正在下载”修改为“正在升级”状态;
3、只有当设备处于“正在下载”状态时,设备才能够使用该接口上报下载进度,其他状态将返回“invalid state”的错误;
4、step如果大于100,将作为上报状态使用(设备处于:待升级、下载中、升级中,这三个状态时,可以通过上报如下状态码完成升级流程。其他状态如:已取消,升级失败、升级成功、暂停时,不能上报如下状态):
状态码 | 说明 |
---|---|
101 | 升级包下载成功(设备状态变成:升级中)。 |
102 | 下载失败,空间不足(设备状态变成:升级失败)。 |
103 | 下载失败,内存溢出(设备状态变成:升级失败)。 |
104 | 下载失败,下载请求超时(设备状态变成:升级失败)。 |
105 | 下载失败,电量不足(设备状态变成:升级失败)。 |
106 | 下载失败,信号不良(设备状态变成:升级失败)。 |
107 | 下载失败,未知异常(设备状态变成:升级失败)。 |
201 | 升级成功,此时会把设备的版本号修改为任务的目标版本(设备状态变成:升级完成)。 |
202 | 升级失败,电量不足(设备状态变成:升级失败)。 |
203 | 升级失败,内存溢出(设备状态变成:升级失败)。 |
204 | 升级失败,升级包与当前任务目标版本不一致(设备状态变成:升级失败)。 |
205 | 升级失败,MD5校验失败(设备状态变成:升级失败)。 |
206 | 升级失败,未知异常(设备状态变成:升级失败)。 |
207 | 达到最大重试次数(设备状态变成:升级失败)。 |
208 | 设备升级过期(设备状态变成:升级失败)。 |
下载中状态可以上报下载中的状态码或者升级中的状态码; 升级中状态只能上报升级中的状态码。
POST http:///ota/south/device/download/ota_MP9qVOT0AtsHhUSNYMy7/progress?dev_id=32981907
Content-Type:application/json
Host: api.heclouds.com
{
"step":50 // [1, 100] 下载进度为50%
}
{
"errno": 0,
"error":“succ”
}