KKonsol Developers
API referenceApplication assignments

List assigned application releases

GET
/device/v1/applications

Lists the application releases this terminal should run. This is the same applications list a heartbeat response carries. Call it when the terminal learns that something changed, or on its own schedule between heartbeats. It does not count as a heartbeat.

Send the ETag of the last response the terminal acted on in If-None-Match; if nothing has changed, the response is 304 with no body. Get a download URL for an assigned release with POST /device/v1/artifact-downloads.

Authorization

DeviceAuth
headerAuthorizationBearer <dvc_<prefix>_<secret>>

The terminal's device token, returned once by POST /device/v1/activations. Send it as Authorization: Bearer <token> on every request except activation.

Header Parameters

If-None-Match?string

The ETag of the last response the terminal acted on.

Response Body

The list. Store its ETag once the terminal has acted on it.

application/json
  1. response

The same applications list a heartbeat response carries. If an application is absent, leave whatever is installed as it is.

applications*array<>
Example Request
curl -X GET 'https://device.konsol.my/device/v1/applications'
Example Response
{  "applications": [    {      "application_id": "48ac72d0-a829-4896-a067-dcb1c2b0f30c",      "application_name": "string",      "outcome": "assigned",      "reason": "string",      "desired_release_id": "58e42f39-089b-4d58-8622-78397444a592",      "desired_release_version": "string",      "artifact": {        "artifact_id": "b7bd6bbb-c7f1-4314-8742-2aeeeece9d12",        "size_bytes": 1,        "sha256": "string",        "file_name": "string",        "media_type": "string",        "install_identifier": "string",        "install_version": "string",        "version_code": 1      },      "uninstall": {        "install_identifier": "string"      },      "updated_at": "2019-08-24T14:15:22Z"    }  ]}