Remote Upgrade OTA
Product Introduction
Product Charge
User guideline
Device development
Upgrade Task Push
API authentication
API List
1- Report Version
2- Detect Device Upgrade Task
3- Detect if token is valid
4- Download Resources
5- Report upgrade status
Other API
Instructions for use of OTA - SDK
Best practice
Common problems
Update log
Detect if token is valid
Request format: GETURL: http://ota.heclouds.com/ota/south/download/{token}/check
This API can be used as needed during device upgrade process by users, and this operation is optional.
I only want to see examples！！！
http header
| Name | Format | Required or not | Description |
|---|---|---|---|
| Content-Type | string | Yes | Must be application/json. |
| Authorization | string | Yes | Security authentication information |
http request parameter
| Name | Format | Required or not | Description |
|---|---|---|---|
| dev_id | long | Yes | Device id |
Return Parameter
| Name | Format | Description |
|---|---|---|
| errno | int | Call error code, where 0 means success. |
| error | string | Error description, where “succ” means success. |
Error Code Description
| Error Codes | Description |
|---|---|
| 0 | Valid |
| 4 | Token and did are inconsistent. |
| 7 | OneNET internal error. |
| 12 | Token is expired and device upgrade process flow is ended. |
| 17 | Invalid status. Token can only be verified when the upgrade task of the device is to be upgraded or under downloading. Token verification is not supported in other status. |
| 20 | Upgrade task is completed and device upgrade process is ended. |
| 21 | Invalid operation, sdk logic error. |
| 22 | Upgrade task is cancelled, it is unnecessary to report upgrade failure. |
Description
After obtaining task information through task detection interface for the device, it is required to carry out token detection through token detection interface (since token is only valid within 2 days).
After token detection interface is called successfully, the platform will change device upgrade task status from “to be upgraded” to “downloading”.
Return Example
{
"errno": 0,
"error": "succ"
}