Wiki source code of WS tacho

Last modified by Admin on 2019/09/10 07:10

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