Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Sv translation
languageen

Get all existing odometer data that have been performed by users of the Customer Portal.

Description

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

Parameter

ParameterDescriptionTypeNoteMandatory
companyRTI company keystring
yes
vehicleRTI vehicle keystring
yes
format

Output format

stringcsv or json, default: csvno

Return

A string will be returned (json or csv). If the request was successful "OK". If the request failed "ERROR:Description".


Possible error values

errordescription
MISSING_COMPANYcompany key is missing
INVALID_COMPANYCompany not found. Company key or import key might be faulty.
ERROR_MAINTENANCEYour company is under maintenance, no RTI request are possible at the moment.

MISSING_VEHICLE

vehicle key is missing
ERROR_
INVALID_FORMATinvalid output format


CSV

Meta informations

SeparatorSemicolon ( ; )
DelimiterDouble quote ( " )
Line break0x0D 0x0A (CarriageReturn LineFeed)
HeaderLine 1

Columns

ColumnDescription
Datum
DATEdate of change
Neuer KM
NEWODOMETEROdometer reading after correction
Alter KM
OLDODOMETEROdometer reading before correction
Faktor
KMCORRECTIONFACTORCorrected value
gesetzt durch
UPDATEBYUsers of the portal

Example

Return in 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"


Return in 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"
    },
    {
        "

Datum

date": "

26.05.2021 16

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

Neuer KM

newOdometer": "257319",
        "

Alter KM

oldOdometer": "0",
        "

Faktor

kmCorrectionFactor": "0",
        "

gesetzt durch

updateBy":

"

 "Mitarbeiter 1"
    },
    {
        "

Datum

date": "

23.11.2021 21:08:13

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

Neuer KM

newOdometer": "

262655

241000",
        "

Alter KM

oldOdometer": "

259434

213597",
        "

Faktor

kmCorrectionFactor": "1.05259",
        "

gesetzt durch

updateBy": "

"

Mitarbeiter

1

2"
    },
    {
        "

Datum

date": "

19.08.2021 13:19:08

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

Neuer KM

newOdometer": "

259434

213597",
        "

Alter KM

oldOdometer": "

257319

198227",
        "

Faktor

kmCorrectionFactor": "1.08232",
        "

gesetzt durch

updateBy": "

"

Mitarbeiter 1"
    },
    {
        "

Datum

date": "

15.06.2016 10:35:50

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

Neuer KM

newOdometer": "

1

198227",
        "

Alter KM

oldOdometer": "

0

195037",
        "

Faktor

kmCorrectionFactor": "1.10995",
        "

gesetzt durch

updateBy": "

Portal

Mitarbeiter 1"
    },
    {
        "

Datum

date": "

14.10.2016 10

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

Neuer KM

newOdometer": "195037",
        "

Alter KM

oldOdometer": "193018",
        "kmCorrectionFactor": "1",
        "updateBy": ""
    },
    {
        "date": "2016-09-07T08:30:51+00:00",
        "newOdometer": "193018",
        

"Faktor

"oldOdometer": "190600",
        "kmCorrectionFactor": "1",
        "

gesetzt durch

updateBy": "Mitarbeiter 2"
    },
    {
        "

Datum

date": "

12.01.2018 17:00:29

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

Neuer KM

newOdometer": "

213597

190600",
        "

Alter KM

oldOdometer": "

198227

1",
        "

Faktor

kmCorrectionFactor": "1.

08232

00021",
        "

gesetzt durch

updateBy":

"

 "Mitarbeiter 2"
    },
    {
        "date": "2016-06-15T10:35:50+00:00",
        "newOdometer": "1",

  [...]

        "oldOdometer": "0",
        "kmCorrectionFactor": "1",
        "updateBy": "Portal"
    }
]


Example call

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