online-update-check 接口
在线检测是否有新版本的固件。
进行检测时,必须满足以下条件:
- 未进行固件升级
 
通过 get-status 接口可以获取到以下信息:
"cur-status": 65552                    // 设备运行状态掩码
cur-status 和 设备状态掩码 进行与运算,可以得到以下状态表:
| 状态 | 条件 | 
|---|---|
| 未进行固件升级 | cur-status & statusUpgrade != statusUpgrade | 
请求方式
GET http://ip/usapi?method=online-update-check
| 参数 | 说明 | 
|---|---|
| method | 方法名称:online-update-check | 
返回数据
{
  "result": 0
}
| 属性 | 说明 | 
|---|---|
| result | 返回状态,0:操作成功,返回其它值请参考 API 状态码 | 
检测过程状态
通过 get-status 接口可以获取到 check-upgrade 和 upgrade 信息,如下:
"check-upgrade": {
  "result": 0,
  "client-id": ""
},
"upgrade": {
  "ver": "1.2.123",
  "date": "2012-1-1 00:00:00",
  "size-byte": 12004784,
  "info": [
    {
      "version": "1.2.123",
      "changelog": "## Develop version 1.2. ## Develop version2."
    }
  ]
}
| 属性 | 说明 | 
|---|---|
| result | 操作状态。 27:初始状态 2:检测中状态 0:操作成功 返回其它值请参考 API 状态码  | 
| ver | 新固件版本号 | 
| date | 新固件发布时间 | 
| size-byte | 新固件文件大小(B) | 
| info | 更新日志 | 
| client-id | 保留属性 | 
检测操作失败后,需要调用 clear-check-update 接口将检测状态重置为初始状态(27)。