KKonsol Developers
API referenceParameter assignments

List assigned parameter documents

GET
/device/v1/parameters

Lists the parameter documents this terminal should hold. This is the same parameters 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. Download each changed document with GET /device/v1/parameters/{application_id}.

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 parameters list a heartbeat response carries. If an application is absent, leave its current parameters as they are.

parameters*array<>
Example Request
curl -X GET 'https://device.konsol.my/device/v1/parameters'
Example Response
{  "parameters": [    {      "application_id": "48ac72d0-a829-4896-a067-dcb1c2b0f30c",      "install_identifier": "string",      "digest": "string",      "schema_revision": 1,      "updated_at": "2019-08-24T14:15:22Z"    }  ]}