Telemetry Snapshots
Returns the latest limit number of telemetry snapshots that contain at least one of the requested parameters that occurred before or at the until time and after the since time. If the until time is not specified, then the service will return snapshots until the current time when the call is made.
Request
GET https://telemetry.vin.li/api/v1/devices/27a2ac50-d7bd-11e3-9c1a-0800200c9a66/snapshots?fields=vehicleSpeed,rpm
Accept: application/json
fields - Comma-separated list of parameter keys to filter by
until - Results will contain snapshots whose timestamps are less than or equal to the until value. If an until value is not specified, the current time when the call is made will be used as the until value.
since - Results will contain snapshots whose timestamps are greater than the since value. If a since value is not specified, no lower limit will be placed on the returned snapshots.
limit - Results will contain no more than limit number of snapshots
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"snapshots": [
{
"id": "090442e2-6c04-3473-bf15-549622329c79",
"timestamp": "2016-12-19T23:05:43.074Z",
"data": {
"vehicleSpeed": 12,
"rpm": 850
},
"links": {
"self": "https://telemetry.vin.li/api/v1/messages/090442e2-6c04-3473-bf15-549622329c79"
}
},
{
"id": "b8664969-dfba-4536-b610-1cdc2657d8b2",
"timestamp": "2016-12-19T23:05:42.198Z",
"data": {
"rpm": 1805
},
"links": {
"self": "https://telemetry.vin.li/api/v1/messages/b8664969-dfba-4536-b610-1cdc2657d8b2"
}
},
{
"id": "89c4d874-cde5-4e7c-b7b4-59ce18d892d3",
"timestamp": "2016-12-19T23:05:41.268Z",
"data": {
"vehicleSpeed": 19,
"rpm": 1768
},
"links": {
"self": "https://telemetry.vin.li/api/v1/messages/89c4d874-cde5-4e7c-b7b4-59ce18d892d3"
}
}
],
"meta": {
"pagination": {
"remaining": 797812,
"until": "2016-12-20T00:11:10.993Z",
"since": "1970-01-01T00:00:00.000Z",
"limit": 3,
"sortDir": "desc",
"links": {
"prior": "https://telemetry.vin.li/api/v1/devices/27a2ac50-d7bd-11e3-9c1a-0800200c9a66/snapshots?fields=vehicleSpeed,rpm"
}
}
}
}