List last-received observation ids by device
- Sandbox: available
- Staging: available
- Production: unknown
Returns the last-received Observation ids for every device in your project, keyed by device identifier.
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 (from the token).
Behaviour
- Covers the devices that have telemetry, up to the first 1000 devices of the project, including devices without a resident.
- Each value has the same shape as
GET /v1/slim/telemetry/{deviceId}/lastIds. Fields arenullwhen nothing has been received for them.
Example
curl -X GET 'https://api.sandbox.ovok.com/v1/slim/telemetry/lastIds' \ -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk'bearerAuthorizationBearer <JWT>Last-received observation ids, keyed by device identifier.
application/json- response
[key: string]?curl -X GET 'https://api.sandbox.ovok.com/v1/slim/telemetry/lastIds'{ "property1": { "heartRate": "string", "respiratoryRate": "string", "sleepStatus": "string", "presenceStatus": "string", "batch": "string" }, "property2": { "heartRate": "string", "respiratoryRate": "string", "sleepStatus": "string", "presenceStatus": "string", "batch": "string" }}List effective observation ids by device GET
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 (from the token). ## Behaviour - Covers the devices that have telemetry, up to the first 1000 devices of the project, including devices without a resident. - Each value has the same shape as `GET /v1/slim/telemetry/{deviceId}/effectiveIds`. Fields are `null` when no reading has set them. ## Example ```bash curl -X GET 'https://api.sandbox.ovok.com/v1/slim/telemetry/effectiveIds' \ -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk' ```
Get effective observation ids for a device GET
Returns, for one device, the ids of the Observations that produced its current heart rate, respiratory rate, sleep status and presence values. Use it to trace a displayed value back to its source reading. **Auth:** bearer token. The caller must be a practitioner, an admin or a System Owner, and needs `Device:read`. **Scope:** a device identifier only resolves when the device is visible to your token and in the caller's project. ## Behaviour - `deviceId` is either the device identifier or the Device resource id (a UUID). - Each field is an Observation id, or `null` when no reading has set that value yet. - Only devices whose readings carry their own Observation id fill these fields. For other devices every field is `null`. - A device that is not found returns every field `null`, not an error. - Lookups of a device are cached for up to 10 minutes, and misses for 30 seconds. ## Example ```bash curl -X GET 'https://api.sandbox.ovok.com/v1/slim/telemetry/c3499c27-2973-0a7f-807e-fb8676a92dcb/effectiveIds' \ -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk' ```