Gibt aktuelle Informationen bezüglich Lenkzeit, Restlenkzeit, Schichtbeginn eines Fahrers zurück auf Basis der Digitacho Infoschnittstelle (D8).
- company - RTI Firmenkennung und
- import - RTI Importschlüssel
- driver - Fahrerschlüssel
- format - Ausgabeformat 'csv' oder 'json' (Optional. Standard ist 'json')
...
Beschreibung
get_d8_driver_time.php?company=(HEXKEY)COMPANY_RTIKEY&import=(HEXKEY)IMPORT_RTIKEY&driver=(DRIVERKEY)DF0123456789000&format=json
Rückgabe
Format JSON
Erklärung der Spalten:
- driverName - Fahrername
- driverKey - Fahrerschlüssel
- steerTimeSeconds - Lenkzeit in Sekunden
- steerTime - Lenkzeit im Format 0h 00m
- workTimeSeconds - Arbeitszeit in Sekunden
- workTime - Arbeitszeit im Format 0h 00m
- remainingTimeSeconds - Restlenkzeit in Sekunden
- remainingTime - Restlenkzeit im Format 0h 00m
- shiftStart - Schichtbeginn im Format YYYY-MM-DD HH:MM:SS
Beispiel:
| Code Block |
|---|
{"driverName":"Mustermann, Paul","driverKey":"DF0123456789000","steerTimeSeconds":4260,"steerTime":"1 h 11 m","workTimeSeconds":180,"workTime":"0 h 3 m","remainingTimeSeconds":28140,"remainingTime":"7 h 49 m","shiftStart":"2015-05-19 04:25:00"} |
Format CSV
Header: "DRIVER_NAME";"DRIVER_KEY";"STEER_SECONDS";"STEER_TIME";"WORK_SECONDS";"WORK_TIME";"REMAINING_SECONDS";"REMAINING_TIME";"SHIFT_START"
csv
Parameter
| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | |
| import | RTI Importschlüssel | string | ja | |
| driver | Fahrerschlüssel | string | ja | |
| format | Rückgabeformat | string | csv oder json (Standard) | nein |
Rückgabe
Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.
CSV Format
Metainformationen
...
| Trennzeichen | Semikolon ( ; ) |
|---|---|
| Textbegrenzer | Doppeltes Hochkomma ( " ) |
| Zeilenende |
| 0x0D 0x0A (CarriageReturn LineFeed) |
| Header |
|---|
...
| Zeile 1 |
...
Spalten
| Spalte | Beschreibung | |
|---|---|---|
| DRIVER_NAME |
...
| Fahrername | ||
| DRIVER_KEY |
...
| Fahrerschlüssel | ||
| STEER_SECONDS |
...
| Tagesaktuelle Lenkzeit in Sekunden | ||
| STEER_TIME |
...
| Tagesaktuelle Lenkzeit |
...
| Format 0h 00m | |
| WORK_SECONDS |
...
| Tagesaktuelle Arbeitszeit in Sekunden | ||
| WORK_TIME |
...
| Tagesaktuelle Arbeitszeit |
...
| Format 0h 00m | |
| REMAINING_SECONDS |
...
| Tagesrestlenkzeit in Sekunden | ||
| REMAINING_TIME |
...
| Tagesrestlenkzeit | Format 0h 00m | |
| SHIFT_START |
...
| Schichtbeginn |
...
| Format YYYY-MM-DD HH:MM:SS |
Beispiel
...
| Code Block |
|---|
"DRIVER_NAME";"DRIVER_KEY";"STEER_SECONDS";"STEER_TIME";"WORK_SECONDS";"WORK_TIME";"REMAINING_SECONDS";"REMAINING_TIME";"SHIFT_START"
"Mustermann, Paul";"DF0123456789000";"4260";"1 h 11 m";"180";"0 h 3 m";"28140";"7 h 49 m";"2015-05-19 04:25:00" |
JSON Format
Spalten
| Spalte | Beschreibung | |
|---|---|---|
| driverName | Fahrername | |
| driverKey | Fahrerschlüssel | |
| steerTimeSeconds | Tagesaktuelle Lenkzeit in Sekunden | |
| steerTime | Tagesaktuelle Lenkzeit | Format 0h 00m |
| workTimeSeconds | Tagesaktuelle Arbeitszeit in Sekunden | |
| workTime | Tagesaktuelle Arbeitszeit | Format 0h 00m |
| remainingTimeSeconds | Tagesrestlenkzeit in Sekunden | |
| remainingTime | Tagesrestlenkzeit | Format 0h 00m |
| shiftStart | Schichtbeginn | Format YYYY-MM-DD HH:MM:SS |
Beispiel
| Code Block |
|---|
{"driverName":"Mustermann, Paul","driverKey":"DF0123456789000","steerTimeSeconds":4260,"steerTime":"1 h 11 m","workTimeSeconds":180,"workTime":"0 h 3 m","remainingTimeSeconds":28140,"remainingTime":"7 h 49 m","shiftStart":"2015-05-19 04:25:00"} |
Beispielaufrufe
| Code Block | ||
|---|---|---|
| ||
http://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000 |
| Code Block | ||
|---|---|---|
| ||
http://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000&format=csv |