online-update-check
Use this interface to check for new firmware versions.
- In order to conduct the firmware checking, an update can not be in progress.
You can obtain current device running status mask using get-status:
"cur-status": 65552 // device running status mask
The output of cur-status & Device Status Mask is as follows:
| Device status | Condition |
|---|---|
| Firmware update is not in progress | cur-status & statusUpgrade != statusUpgrade |
HTTP Request
GET http://ip/usapi?method=online-update-check
| Parameter | Description |
|---|---|
| method | online-update-check |
Response Body
{
"result": 0
}
| Item | Description |
|---|---|
| result | 0 indicates that the request was accepted successfully. Refer to API Status Codes to find specific description for other values. |
Detection Status
Obtain check-upgrade and upgrade using get-status.
"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."
}
]
}
| Item | Description |
|---|---|
| result | Indicates returned status. 27: initial status 2: checking 0: the request was accepted successfully. Refer to API Status Codes to find specific description for other values. |
| ver | Indicates new firmware version. |
| date | Indicates release date of the new firmware. |
| size-byte | Indicates file size of new firmware(B). |
| info | Indicates release note. |
| client-id | Reserved. |
Call clear-check-update to reset the status to Initial status(27) after detection failed.