遠程升級OTA
產品簡介
產品定價
使用者指南
設備開發
最佳實踐
常見問題
更新日誌
獲取設備正在升級（下載中/升級中）的token
請求方式：GETURL：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：差分包
}
}