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

# 检测升级任务

请求方式:GET

URL: http://ota.heclouds.com/ota/check

http头部

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

http 请求参数

参数名称 格式 是否必须 说明
dev_id string 设备id
manuf string 厂商名称
model string 模组型号
type int 任务类型,1代表FOTA任务,2代表SOTA任务
version string 版本信息
signals int 信号强度
powers int 剩余电量百分比
cdn boolean 设备支持域名解析请选择true,若设备不支持域名解析请选择false

返回参数

参数名称 格式 说明
errno int 调用错误码,详见错误码说明
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码
ip string 拉取升级包的ip地址

错误码说明

错误码 说明
0 检测成功
7 OneNET内部错误
8 检测失败,设备存在升级任务,manuf或者model不一致
9 检测失败,设备存在升级任务,version不一致
10 检查失败,设备存在升级任务,signal或者powers不一致
11 检查失败,设备不存type(fota/sota)对应的升级任务
13 检查失败,设备存在升级任务,但是任务状态无效
19 检测失败,设备任务以暂停

http请求参数示例

{
    "dev_id": 6523,
    "manuf": "中国移动",
    "model": "M5310",
    "type": 1,
    "version":"1.2" ,
    "signals": 10,
    "powers":30,
    "cdn": true

}

返回示例

{
    "errno": 0,
    "error": "succ",
    "data": {
        "target":"1.2",
        "token":"dafddad",
        "size":123,
        "signal":12,
        "power":90,
        "retry":10,
        "interval":90,
        "md5":"dfkdajkfd",
         "ip":"172.19.3.3"
    }
}

个搜索结果,搜索内容 “

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