Telemetry
List effective observation ids by device
List effective observation ids by device using Ovok’s Slim API.
| Method | Path |
|---|---|
GET | /v1/slim/telemetry/effectiveIds |
Authentication · Access policies
Returns the effective Observation ids for every device in your project, keyed by device identifier. These are the readings that produced each device's current heart rate, respiratory rate, sleep status and presence values.
Auth: bearer token. The caller must be a practitioner, an admin or a System Owner, and needs Device:read and Device:search.
Scope: the caller's project and its sub-projects (from the token).
Request
No parameters.
Behaviour
- Covers the devices that have telemetry, up to the first 1000 devices of the project, including devices without a resident. Devices are taken in resident-name order, so devices without a resident come last and are the ones left out of a larger project.
- Each value has the same shape as
GET /v1/slim/telemetry/{deviceId}/effectiveIds. Fields arenullwhen no reading has set them. - Devices that have no ids recorded still get a key, with every field
null. - The route returns 503 when the server is at capacity for live reads or the device list cannot be built. Retry shortly.
Example
curl -X GET 'https://api.sandbox.ovok.com/v1/slim/telemetry/effectiveIds' \
-H "Authorization: Bearer ${OVOK_TOKEN}"Successful response
200 — Effective observation ids, keyed by device identifier.
{
"Demo/3001000": {
"heartRate": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b51",
"respiratoryRate": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b52",
"sleepStatus": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b53",
"presenceStatus": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b54"
},
"Demo/3001001": {
"heartRate": null,
"respiratoryRate": null,
"sleepStatus": null,
"presenceStatus": null
}
}| Field | Type | Description |
|---|---|---|
<deviceIdentifier> | object | One key per device, named by the device identifier, for example Demo/3001000. |
<deviceIdentifier>.heartRate | string | null | Observation id behind the current heart rate. null when no reading has set it yet. |
<deviceIdentifier>.respiratoryRate | string | null | Observation id behind the current respiratory rate. null when no reading has set it yet. |
<deviceIdentifier>.sleepStatus | string | null | Observation id behind the current sleep status. null when no reading has set it yet. |
<deviceIdentifier>.presenceStatus | string | null | Observation id behind the current presence status. null when no reading has set it yet. |
An empty project returns {}.
Errors
| Status | Meaning |
|---|---|
401 | Bearer token is missing, invalid or expired. |
403 | You are not a practitioner, admin or System Owner, you lack Device:read or Device:search, your session has no project, or you cannot access the project. |
404 | Your session has no project (admin sessions only). |
503 | The server is at capacity for live reads (the body has error: "live_reads_over_capacity" (live_reads_over_capacity) and retryAfterSec, and the Retry-After header is set), the device list cannot be built right now (no Retry-After), or the access policy cannot be read. Retry shortly. |
Last updated on