Wiki source code of WS tacho

Version 3.5 by Admin on 2019/09/10 06:32

Hide last authors
Admin 2.2 1 {{code language="none" title="**Request URL**"}}
Admin 3.4 2 GET http://etransportas.aktkc.lt/gps/api/ws/tacho.ws?key=KEY&uid=UID
Admin 2.2 3 {{/code}}
4
5
6 |=(% colspan="4" style="text-align: center;" %)Request parameters
7 |=(% style="text-align: center;" %)Property|=(% style="text-align: center;" %)Type|=(% style="text-align: center;" %)Description|=Default
Admin 2.3 8 |uid|Number|User Id in Webfleet system|
9 |key|String|Authentication key: MD5(username;password;client_IP_Address)|
Admin 3.5 10 |key2|String|Authentication key: Key generation algorithm|
Admin 2.2 11
12 {{code language="json" title="**Response**"}}
Admin 2.5 13 {
14 "status": {
15 "code": 200,
16 "message": "OK"
17 },
18 "body": {
19 "tachos": [{
20 "carId": 15159,
21 "carNr": "KJO 617",
22 "tachoState": 3,
23 "driver1EventMinutesBefore": 4,
24 "driver1FullName": "VAIDAS SESETAS",
25 "driver1Data": {
26 "driveShort": 245,
27 "driveLong": 531,
28 "restingNow": 0,
29 "restLeft": 0,
30 "weekTotalDrivenMinutes": 69,
31 "driveThisWeekLeft": 3291,
32 "minutesToDailyRest": 1105,
33 "minutesTillWeeklyRest": 4223,
34 "weekReducedDailyRests": 0,
35 "nineHoursTimesExceeded": 0
36 },
37 "driver2EventMinutesBefore": 880,
38 "driver2FullName": "LAIMUTIS SAMUOLIS",
39 "bothDriversCombinedData": {
40 "driveLong": 833,
41 "driveThisWeek": 5114
42 }
43 },
Admin 2.2 44 {
Admin 2.5 45 "carId": 13268,
46 "carNr": "HZA 917",
47 "tachoState": 0,
48 "driver1EventMinutesBefore": 1,
49 "driver1FullName": "ARUNAS MILEVSKIS",
50 "driver1Data": {
51 "driveShort": 270,
52 "driveLong": 600,
53 "restingNow": 847,
54 "restLeft": 0,
55 "driveThisWeek": 3360,
56 "weekTotalDrivenMinutes": 0,
57 "driveThisWeekLeft": 3360,
58 "minutesToDailyRest": 1260,
59 "minutesTillWeeklyRest": 7775,
60 "weekReducedDailyRests": 0,
61 "nineHoursTimesExceeded": 0
62 },
63 "driver2EventMinutesBefore": 4870,
64 "driver2FullName": "JOSIF MACEL",
65 "bothDriversCombinedData": {
66 "driveLong": 1002,
67 "driveThisWeek": 6028
Admin 2.2 68 }
Admin 2.5 69 },
Admin 2.2 70 {
Admin 2.5 71 "carId": 10762,
72 "carNr": "GZD 408",
73 "tachoState": 0,
74 "driver1EventMinutesBefore": 4,
75 "driver1FullName": "SIARHEI HERASIMIUK",
76 "driver1Data": {
77 "driveShort": 0,
78 "driveLong": 181,
79 "restingNow": 33,
80 "restLeft": 0,
81 "weekTotalDrivenMinutes": 360,
82 "driveThisWeekLeft": 0,
83 "minutesToDailyRest": 396,
84 "minutesTillWeeklyRest": 0,
85 "weekReducedDailyRests": 0,
86 "nineHoursTimesExceeded": 0
87 }
Admin 2.2 88 }
Admin 2.5 89 }]
Admin 2.2 90 }
91 }
92 {{/code}}
93
94
Admin 2.6 95 |=(% colspan="3" style="text-align: center;" %)Json Body parameters
Admin 2.2 96 |=(% style="text-align: center;" %)Property|=(% style="text-align: center;" %)Type|=(% style="text-align: center;" %)Description
Admin 2.6 97 |tachos|Array|Array of tacho records
Admin 2.2 98
Admin 2.25 99 |=(% colspan="3" style="text-align: center;" %)Array node tachos parameters
Admin 2.2 100 |=(% style="text-align: center;" %)Property|=(% style="text-align: center;" %)Type|=(% style="text-align: center;" %)Description
Admin 2.18 101 |carId|Integer|Car ID webfleet app
Admin 2.7 102 |carNr|String|format "XXX 111"
Admin 2.20 103 |tachoState|Integer|Values: 0 - break/rest, 1 - availability, 2- work, 3 - drive
Admin 2.10 104 |driver1EventMinutesBefore|Integer|Driver 1 event data received before X minutes
Admin 2.14 105 |driver1FullName|String|Driver 1 full name
Admin 2.16 106 |driver1Data |Object|Data of driver 1
Admin 2.13 107 |driver2EventMinutesBefore |Integer|Driver 2 event data received before X minutes (if exists)
Admin 2.15 108 |driver2FullName |String|Driver 2 full name (if exists)
Admin 2.16 109 |bothDriversCombinedData |Object|Both drivers data (if exists)
Admin 2.2 110
Admin 2.19 111 |=(% colspan="3" style="text-align: center;" %)Object node driver1Data parameters
Admin 2.2 112 |=(% style="text-align: center;" %)Property|=(% style="text-align: center;" %)Type|=(% style="text-align: center;" %)Description
Admin 2.30 113 |driveShort|(% style="font-family:sans-serif; white-space:pre-wrap" %)Integer|4.5 hours interval left time in minutes
Admin 2.41 114 |driveLong |(% style="font-family:sans-serif; white-space:pre-wrap" %)Integer|Day left time in minutes
Admin 2.31 115 |restingNow |Integer|Resting now time in minutes
Admin 2.30 116 |restLeft|Integer|Rest time left in minutes
Admin 2.33 117 |weekTotalDrivenMinutes |Integer|Week drive total time in minutes
Admin 2.34 118 |driveThisWeekLeft|Integer|Week drive time left in minutes
119 |minutesToDailyRest |Integer|Minutes left until daily rest
120 |minutesTillWeeklyRest |Integer|Minutes left until weekly rest
Admin 2.40 121 |weekReducedDailyRests |Integer|Count of 9 hours rests during the week period
122 |nineHoursTimesExceeded|Integer|Count of more than 9 hours of work days during the week period
Admin 2.26 123
Admin 2.27 124 |=(% colspan="3" style="text-align: center;" %)Object node bothDriversCombinedData parameters
Admin 2.42 125 |=(% style="text-align: center; width: 343px;" %)Property|=(% style="text-align: center; width: 188px;" %)Type|=(% style="text-align: center;" %)Description
Admin 2.45 126 |(% style="width:343px" %)driveShort|(% style="font-family:sans-serif; white-space:pre-wrap; width:188px" %)Integer|4.5 hours interval left time in minutes (if exists)
127 |(% style="width:343px" %)driveLong|(% style="font-family:sans-serif; white-space:pre-wrap; width:188px" %)Integer|Day left time in minutes (if exists)
128 |(% style="width:343px" %)restingNow|(% style="font-family:sans-serif; white-space:pre-wrap; width:188px" %)Integer|Resting now time in minutes (if exists)
129 |(% style="width:343px" %)restLeft|(% style="font-family:sans-serif; white-space:pre-wrap; width:188px" %)Integer|Rest time left in minutes (if exists)
130 |(% style="width:343px" %)driveThisWeek |(% style="font-family:sans-serif; white-space:pre-wrap; width:188px" %)Integer|Week drive time left in minutes (if exists)