OneNET物联网平台 平台介绍 入门手册 设备开发指南 应用开发指南
API
API使用 API列表 SDK MQTT LwM2M EDP Modbus TCP
消息队列MQ HTTP推送
服务定价 扩展服务 常见问题 发布公告



上报升级状态

请求方式:POST

URL: http(s)://ota.heclouds.com/ota/south/device/download/{token}/progress

我只想看示例!!!

http头部

参数名称格式是否必须说明
Content-Typestring必须为application/json
Authorizationstring安全鉴权信息

http 请求参数

参数名称格式是否必须说明
dev_idstring设备id

http 请求内容

参数名称格式是否必须说明
stepint取值为[0,100],下载进度比

返回参数

参数名称格式说明
errnoint调用错误码,为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

http请求参数示例

{

  "step":50 // [1, 100] 下载进度为50%

}

返回示例

{

    "errno": 0,

    "error":“succ”

}

个搜索结果,搜索内容 “

    0 个搜索结果,搜索内容 “