Versions Compared

Old Version 8

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 9

changes.mady.by.user YellowFox R&D

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede

Abrufen aller vorhandenen Kilometerstandsabgleiche die von Nutzern des Kunden Portals durchgeführt wurden.

Beschreibung

GET  /vehicle_settings/get_odometer_history.php?company=RTI_COMPANYKEY&vehicle=VEHICLE_RTIKEY

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring
ja
vehicleRTI Fahrzeugschlüsselstringentweder vehicle, group oder import Parameterja
format

Ausgabeformat

stringcsv oder json, standard: csvnein

Rückgabe

Es wird ein string zurückgegeben (json oder csv) . Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.


Mögliche Fehlerwerte

FehlerBeschreibung
MISSING_COMPANYFirmenschlüssel fehlt
INVALID_COMPANYFirma nicht gefunden. Dies kann an einem fehlerhaften Firmen- oder Import-Schlüssel liegen. 
ERROR_MAINTENANCEIhre Firma wird gerade gewartet, währenddessen sind keine RTI Abfragen möglich.

MISSING_VEHICLE

Fahrzeugschlüssel fehlt
ERROR_INVALID_FORMATDas übergebene Format ist nicht json oder csv


CSV

Metainformationen

TrennzeichenSemikolon ( ; )
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1

Spalten

SpalteBeschreibung
DatumDATEDatum der Änderung
Neuer KMNEWODOMETERKilometerstand nach der Korrektur
Alter KMOLDODOMETERKilometerstand vor der Korrektur
FaktorKMCORRECTIONFACTORKorrekturwert
gesetzt durchUPDATEBYNutzer des Portals


Rückgabe als CSV

"

Datum

DATE";"

Neuer KM

NEWODOMETER";"

Alter KM

OLDODOMETER";"

Faktor

KMCORRECTIONFACTOR";"

gesetzt durch

UPDATEBY"

"

26.05.2021 16:14:54

2021-11-23T21:08:13+00:00";"

257319

262655";"

0

259434";"

0

1";"Mitarbeiter 1"

"

23.11.2021 21

2021-08-19T13:19:08+00:

13

00";"

262655

259434";"

259434

257319";"1";"Mitarbeiter 1"

"

19.08.2021 13:19:08

2021-05-26T16:14:54+00:00";"

259434

257319";"

257319

0";"

1

0";"Mitarbeiter 1"

"

15.06.2016 10:35:50

2019-08-06T14:18:47+00:00";"

1

241000";"

0

213597";"1.05259";"

Portal

Mitarbeiter 2"

"

14.10.2016 10:50:58

2018-01-12T17:00:29+00:00";"

195037

213597";"

193018

198227";"1.08232";"Mitarbeiter 1"

"

12.01.2018 17:00:29

2017-02-03T15:34:37+00:00";"

213597

198227";"

198227

195037";"1.

08232

10995";"Mitarbeiter

2

1"

"

11.08.2016 18:12:12

2016-10-14T10:50:58+00:00";"

190600

195037";"

1

193018";"1

.00021

";"

Mitarbeiter 1

"

"

07.09.2016 08

2016-09-07T08:30:51+00:00";"193018";"190600";"1";"Mitarbeiter

1

2"

"

06.08.2019 14:18:47

2016-08-11T18:12:12+00:00";"

241000

190600";"

213597

1";"1.

05259

00021";"Mitarbeiter 2"

"

03.02.2017 15:34:37

2016-06-15T10:35:50+00:00";"

198227

1";"

195037

0";"1

.10995

";"

Mitarbeiter 1

Portal"



Rückgabe als JSON

[
    {
        "date": "2021-11-23T21:08:13+00:00",
        "newOdometer": "262655",
        "oldOdometer": "259434",
        "kmCorrectionFactor": "1",
        "updateBy": "Mitarbeiter 1"
    },
    {
        "date": "2021-08-19T13:19:08+00:00",
        "newOdometer": "259434",
        "oldOdometer": "257319",
        "kmCorrectionFactor": "1",
        "updateBy": "Mitarbeiter 1"
    },
    {
        "Datumdate": "26.05.2021 162021-05-26T16:14:54+00:00",
        "Neuer KMnewOdometer": "257319",
        "Alter KMoldOdometer": "0",
        "FaktorkmCorrectionFactor": "0",
        "gesetzt durchupdateBy": " "Mitarbeiter 1"
    },
    {
        "Datumdate": "23.11.2021 21:08:132019-08-06T14:18:47+00:00",
        "Neuer KMnewOdometer": "262655241000",
        "Alter KMoldOdometer": "259434213597",
        "FaktorkmCorrectionFactor": "1.05259",
        "gesetzt durchupdateBy": ""Mitarbeiter 12"
    },
    {
        "Datumdate": "19.08.2021 13:19:082018-01-12T17:00:29+00:00",
        "Neuer KMnewOdometer": "259434213597",
        "Alter KMoldOdometer": "257319198227",
        "FaktorkmCorrectionFactor": "1.08232",
        "gesetzt durchupdateBy": ""Mitarbeiter 1"
    },
    {
        "Datumdate": "15.06.2016 10:35:502017-02-03T15:34:37+00:00",
        "Neuer KMnewOdometer": "1198227",
        "Alter KMoldOdometer": "0195037",
        "FaktorkmCorrectionFactor": "1.10995",
        "gesetzt durchupdateBy": "PortalMitarbeiter 1"
    },
    {
        "Datumdate": "14.10.2016 102016-10-14T10:50:58+00:00",
        "Neuer KMnewOdometer": "195037",
        "Alter KMoldOdometer": "193018",
        "kmCorrectionFactor": "1",
        "updateBy": ""
    },
    {
        "date": "2016-09-07T08:30:51+00:00",
        "newOdometer": "193018",
        "Faktor"oldOdometer": "190600",
        "kmCorrectionFactor": "1",
        "gesetzt durchupdateBy": "Mitarbeiter 2"
    },
    {
        "Datumdate": "12.01.2018 17:00:292016-08-11T18:12:12+00:00",
        "Neuer KMnewOdometer": "213597190600",
        "Alter KMoldOdometer": "1982271",
        "FaktorkmCorrectionFactor": "1.0823200021",
        "gesetzt durchupdateBy": " "Mitarbeiter 2"
    },
    {
        "date": "2016-06-15T10:35:50+00:00",
        "newOdometer": "1",
  [...]        "oldOdometer": "0",
        "kmCorrectionFactor": "1",
        "updateBy": "Portal"
    }
]

Beispielaufruf

https://map.yellowfox.de/rti/vehicle_settings/get_odometer_history.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY

https://map.yellowfox.de/rti/vehicle_settings/get_odometer_history.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&format=csv

https://map.yellowfox.de/rti/vehicle_settings/get_odometer_history.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&format=json

...