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



获取设备正在升级(下载中/升级中)的token

请求方式:GET

URL: http(s)//ota.heclouds.com/ota/south/tasking

目前可以使用“检测设备升级任务”API进行替代。

我只想看示例!!!

http头部

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

http请求参数

参数名称格式是否必须说明
dev_idstring设备id
typeint1:fota任务,2:sota任务
cdnboolean是否返回拉取升级包ip

返回参数

参数名称格式说明
errnoint调用错误码,为0表示调用成功
error string错误描述,为"succ"表示调用成功
data json接口调用成功之后返回的设备相关信息,见data描述表

data描述表

参数名称格式说明
targetstring升级任务的目标版本
tokenstring文件地址 ip:port/ota/download/{token}
sizeint文件大小
signalint任务在大于该信号下进行
powerint任务在大于该电量下进行
retryint重试次数
intervalint重试间隔
md5string升级文件的md5码
ipPort string拉取升级包的ip地址
typeint1:完整包,2:差分包

错误码说明

错误码说明
0有效。
2type参数错误。
4not found 没有找到有效的token,可能是由于没有升级任务,或者升级任务的token过期。
7OneNET内部错误。
12token过期,设备升级流程结束。

请求参数示例

{
    "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:差分包
    }
}

个搜索结果,搜索内容 “

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