Management app
These operations (on Encedo PPA only) allow the build-in management application to be upgraded. This includes integrity and signature validation allowing only a legitimate application to be installed.
Embedded Flash Drive is available on Encedo PPA only. On Encedo EPA those endpoints are not available, response code 404 will be returned.
The Authorization header is not required on fresh, not personalized devices.
TLS connection is not required. It is a last resort way to upload fixes. Firmware is signed anyway, no worry about the integrity or genuineness.
Upload a file
Upload a new file
https://my.ence.do/api/system/upgrade/upload_uiUpload a new app image (webroot.tar) file.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization | String | Bearer JWT_TOKEN |
| Content-Type* | String | application/octet-stream |
| Content-Disposition* | String | attachment; filename="webroot.tar" |
| Expect* | String | 100-continue |
Response status code
- 200: Operation successful
- 401: Missing or invalid JWT_TOKEN
- 403: Incorrect access scope
- 406: Operation failed
- 411: Protocol error - Content-Length required
- 412: Protocol error - CORS validation failed
- 413: Protocol error - request body too big
- 500: Internal server error
No response body.
No response body.
No response body.
No response body.
No response body.
No response body.
No response body.
No response body.
Log entries
| Event | Result | Source |
|---|---|---|
| LOG_TYPE_FAILED_SCOPE_CHECK | LOG_RESULT_FAILED | 403 |
Validate a file
Check a file
https://my.ence.do/api/system/upgrade/check_uiCheck the signature and integrity of the newly uploaded app image.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization | String | Bearer JWT_TOKEN |
Response status code
- 200: Operation successful
- 201: Process of validation started
- 202: Validation ongoing
- 401: Missing or invalid JWT_TOKEN
- 403: Incorrect access scope
- 406: Operation failed
- 409: Incorrect internal state
- 412: Protocol error - CORS validation failed
No response body.
No response body.
No response body.
No response body.
No response body.
No response body.
No response body.
No response body.
Log entries
| Event | Result | Source |
|---|---|---|
| LOG_TYPE_FAILED_SCOPE_CHECK | LOG_RESULT_FAILED | 403 |
Install the new management app
https://my.ence.do/api/system/upgrade/install_uiA new version of Encedo Manager will be installed on Encedo PPA.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization | String | Bearer JWT_TOKEN |
Response status code
- 200: Operation successful
- 401: Missing or invalid JWT_TOKEN
- 403: Incorrect access scope
- 409: Incorrect internal state
- 406: Operation failed
- 412: Protocol error - CORS validation failed
No response body.
No response body.
No response body.
No response body.
No response body.
No response body.
Log entries
| Event | Result | Source |
|---|---|---|
| LOG_TYPE_FAILED_SCOPE_CHECK | LOG_RESULT_FAILED | 403 |
| LOG_TYPE_UPGRADE | LOG_RESULT_ERROR | 406 |
| LOG_TYPE_UPGRADE | LOG_RESULT_ERROR | 409 |
| LOG_TYPE_UPGRADE | LOG_RESULT_OK | 200 |