远程升级OTA
产品简介
产品定价
用户指南
设备开发
最佳实践
常见问题
更新日志
获取设备正在升级（下载中/升级中）的token
请求方式：GET
URL: http//ota.heclouds.com/ota/south/tasking
目前可以使用“检测设备升级任务”API进行替代。
http头部
| 参数名称 | 格式 | 是否必须 | 说明 |
|---|---|---|---|
| Content-Type | string | 是 | 必须为application/json |
| Authorization | string | 是 | 安全鉴权信息 |
http请求参数
| 参数名称 | 格式 | 是否必须 | 说明 |
|---|---|---|---|
| dev_id | long | 是 | 设备id |
| type | int | 是 | 1:fota任务,2:sota任务 |
| cdn | boolean | 否 | true|false,是否返回拉取升级包ip |
返回参数
| 参数名称 | 格式 | 说明 |
|---|---|---|
| errno | int | 调用错误码，为0表示调用成功 |
| error | string | 错误描述，为"succ"表示调用成功 |
| data | json | 接口调用成功之后返回的设备相关信息，见data描述表 |
data描述表
| 参数名称 | 格式 | 说明 |
|---|---|---|
| target | string | 升级任务的目标版本 |
| token | string | 文件地址 ip:port/ota/download/{token} |
| size | int | 文件大小 |
| signal | int | 任务在大于该信号下进行 |
| power | int | 任务在大于该电量下进行 |
| retry | int | 重试次数 |
| interval | int | 重试间隔 |
| md5 | string | 升级文件的md5码 |
| ipPort | string | 拉取升级包的ip地址 |
| type | int | 1:完整包，2：差分包 |
错误码说明
| 错误码 | 说明 |
|---|---|
| 0 | 有效。 |
| 2 | type参数错误。 |
| 4 | not found 没有找到有效的token，可能是由于没有升级任务，或者升级任务的token过期。 |
| 7 | OneNET内部错误。 |
| 12 | token过期，设备升级流程结束。 |
请求参数示例
{
"dev_id":6523, //设备id
"type":1, //1:fota任务,2:sota任务
"cdn": true //是否返回拉取升级包ip，选填
}
返回示例
{
"errno": 0,
"error":"succ",
"data":
{
"target":"1.2", // 升级任务的目标版本
"token":"ota_5hc95SFeo5xJEnaNrste",//文件地址ip:port/ota/download/{token}
"size":123,//文件大小
"signal":12,//任务在大于该信号下进行
"power":90,//任务在大于该电量下进行
"retry":10,//重试次数
"interval":90,//重试间隔
"md5":"dfkdajkfd",//升级文件的md5
"ipPort":"172.19.3.3:8002", //拉取升级包的ip地址
"type":1 // 1:完整包，2：差分包
}
}