Key History
Provides a log of all access key activity for the selected period of time. Access key activity is defined by unit operated, location, timestamp, movement (if any) with heading and speed, external power level etc.
URL Structure is:
https://api.trackunit.com/public/Report/KeyHistory
GetKeyHistory
Parameters
Name | Data type | Unit of measurement | Note |
---|---|---|---|
keyId * | String | N/A | KeyId to request summary for. |
from * | DateTime | UTC | The start date. |
to * | DateTime | UTC | The end date. |
Columns
Refer to the following table for description of columns:
Name | Data type | Unit of measurement | Nullability | Note |
---|---|---|---|---|
unitId | String | UTC | TRUE | |
time | DateTime | UTC | TRUE | Timestamp. |
location | Location | N/A | TRUE | |
address | Address | N/A | TRUE | |
heading | INT | Degrees | TRUE | Unit heading (when moving). |
speed | Double | Km/h | TRUE | Unit speed. |
km | Double | Km | FALSE | |
run1 | Double | Seconds | FALSE | |
run2 | Double | Seconds | FALSE | |
temperature1 | Double | Degrees | TRUE | |
temperature2 | Double | Degrees | TRUE | |
input1 | Bool | N/A | FALSE | |
input2 | Bool | N/A | FALSE | |
output3 | Book | N/A | FALSE | |
batteryLevel | Double | Percent | TRUE | Battery level (internal battery). |
externalPower | Double | Mili Volts | TRUE | External power level. |
Request (example)
{
"keyId": "57899",
"from": "2014-09-02T13:00:00.0000000",
"to": "2014-09-02T14:05:00.0000000"
}
Response
{
"list": [
{
"unitId": "57899",
"time": "2014-09-02T13:59:09.0000000Z",
"location": {
"latitude": 48.7669866666667,
"longitude": 13.046835
},
"address": {
"country": "DE",
"zipCode": "94491",
"city": "Hengersberg",
"streetAddress": "Donaustraße 7"
},
"heading": 0,
"speed": 0,
"km": 231.7,
"run1": 2760840,
"run2": 2760840,
"runOdo": 27600,
"input1": true,
"input2": true,
"output3": false,
"batteryLevel": 100,
"externalPower": 13.8
},
{
"unitId": "57899",
"time": "2014-09-02T13:59:11.0000000Z",
"location": {
"latitude": 48.7669833333333,
"longitude": 13.0468433333333
},
"address": {
"country": "DE",
"zipCode": "94491",
"city": "Hengersberg",
"streetAddress": "Donaustraße 7"
},
"heading": 0,
"speed": 0,
"km": 231.7,
"run1": 2760840,
"run2": 2760840,
"runOdo": 27600,
"input1": true,
"input2": true,
"output3": false,
"batteryLevel": 100,
"externalPower": 13.6
},
{
"unitId": "57899",
"time": "2014-09-02T14:01:05.0000000Z",
"location": {
"latitude": 48.7670466666667,
"longitude": 13.0471833333333
},
"address": {
"country": "DE",
"zipCode": "94491",
"city": "Hengersberg",
"streetAddress": "Donaustraße 9"
},
"heading": 38,
"speed": 1,
"km": 231.7,
"run1": 2760960,
"run2": 2760960,
"runOdo": 27600,
"input1": true,
"input2": true,
"output3": false,
"batteryLevel": 100,
"externalPower": 13.6
}
]
}
Updated about 3 years ago