vehicle_settings/get_odometer_history.php

Zuletzt geändert von YellowFox_RD am 2025/01/20 15:36

Inhaltsverzeichnis

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
formatAusgabeformatstringcsv 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_VEHICLEFahrzeugschlüssel fehlt
INVALID_FORMATDas übergebene Format ist nicht json oder csv

CSV

Metainformationen

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

Spalten

SpalteBeschreibung
DATEDatum der Änderung
NEWODOMETERKilometerstand nach der Korrektur
OLDODOMETERKilometerstand vor der Korrektur
KMCORRECTIONFACTORKorrekturwert
UPDATEBYNutzer des Portals
Rückgabe als CSV
"DATE";"NEWODOMETER";"OLDODOMETER";"KMCORRECTIONFACTOR";"UPDATEBY"
"2021-11-23T21:08:13+00:00";"262655";"259434";"1";"Mitarbeiter 1"
"2021-08-19T13:19:08+00:00";"259434";"257319";"1";"Mitarbeiter 1"
"2021-05-26T16:14:54+00:00";"257319";"0";"0";"Mitarbeiter 1"
"2019-08-06T14:18:47+00:00";"241000";"213597";"1.05259";"Mitarbeiter 2"
"2018-01-12T17:00:29+00:00";"213597";"198227";"1.08232";"Mitarbeiter 1"
"2017-02-03T15:34:37+00:00";"198227";"195037";"1.10995";"Mitarbeiter 1"
"2016-10-14T10:50:58+00:00";"195037";"193018";"1";""
"2016-09-07T08:30:51+00:00";"193018";"190600";"1";"Mitarbeiter 2"
"2016-08-11T18:12:12+00:00";"190600";"1";"1.00021";"Mitarbeiter 2"
"2016-06-15T10:35:50+00:00";"1";"0";"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"
    },
    {
        "date": "2021-05-26T16:14:54+00:00",
        "newOdometer": "257319",
        "oldOdometer": "0",
        "kmCorrectionFactor": "0",
        "updateBy": "Mitarbeiter 1"
    },
    {
        "date": "2019-08-06T14:18:47+00:00",
        "newOdometer": "241000",
        "oldOdometer": "213597",
        "kmCorrectionFactor": "1.05259",
        "updateBy": "Mitarbeiter 2"
    },
    {
        "date": "2018-01-12T17:00:29+00:00",
        "newOdometer": "213597",
        "oldOdometer": "198227",
        "kmCorrectionFactor": "1.08232",
        "updateBy": "Mitarbeiter 1"
    },
    {
        "date": "2017-02-03T15:34:37+00:00",
        "newOdometer": "198227",
        "oldOdometer": "195037",
        "kmCorrectionFactor": "1.10995",
        "updateBy": "Mitarbeiter 1"
    },
    {
        "date": "2016-10-14T10:50:58+00:00",
        "newOdometer": "195037",
        "oldOdometer": "193018",
        "kmCorrectionFactor": "1",
        "updateBy": ""
    },
    {
        "date": "2016-09-07T08:30:51+00:00",
        "newOdometer": "193018",
        "oldOdometer": "190600",
        "kmCorrectionFactor": "1",
        "updateBy": "Mitarbeiter 2"
    },
    {
        "date": "2016-08-11T18:12:12+00:00",
        "newOdometer": "190600",
        "oldOdometer": "1",
        "kmCorrectionFactor": "1.00021",
        "updateBy": "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