NNarya Developers
API referenceDevice parameters

Get a device's resolved application parameters

GET
/integration/v1/devices/{id}/applications/{application_id}/parameters/resolved

Returns the values Narya resolves for this device and application.

Narya applies the schema defaults, then the application's values, then the device's overrides. The response also shows what the device last reported holding.

Authorization

integrationKey
headerAuthorizationBearer <token>

Your integration key, sent as Authorization: Bearer nik_<prefix>_<secret>. Narya issues it.

Path Parameters

id*string
Formatuuid
application_id*string
Formatuuid

Response Body

The resolved parameters

application/json
  1. response

The values Narya resolves for one device and application, and what the device last reported holding.

values*

A nested values document that follows one schema revision. Secret fields are returned in the clear, so do not log or display them unmasked.

digest*ParameterDigest

A fingerprint of a set of resolved parameter values. Equal values always give the same digest, so a device that reports this digest already holds these values.

Match^sha256:[0-9a-f]{64}$
schema_revision*integer

The published schema revision values follows.

Range1 <= value
complete*boolean

False when a required field resolves to no value.

unresolved*array<string>

The dotted paths of required fields that resolve to no value.

applied_last_modified_at*|

The last_modified_at of the override write standing for this device, or null when none has been applied.

Formatdate-time
device*

The device's last report. never_reported means Narya has not heard from the device about these parameters yet.

Example Request
curl -X GET 'https://api-narya-staging.pmadvisors.my/integration/v1/devices/497f6eca-6276-4993-bfeb-53cbbbba6f08/applications/497f6eca-6276-4993-bfeb-53cbbbba6f08/parameters/resolved'
Example Response
{  "values": {},  "digest": "sha256:3b1f2a8c9d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8",  "schema_revision": 1,  "complete": true,  "unresolved": [    "string"  ],  "applied_last_modified_at": "2019-08-24T14:15:22Z",  "device": {    "status": "in_sync",    "digest": "sha256:3b1f2a8c9d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8",    "applied_at": "2019-08-24T14:15:22Z",    "observed_at": "2019-08-24T14:15:22Z"  }}