Versions Compared

Key

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

Liefert per RS-232 übertragene Daten.

Beschreibung

Status
colourGreen
titleGET
 get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=csv

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring
ja
vehicleRTI Fahrzeugschlüsselstring
ja
startAnfang des Abfragezeitraumdatestring

Format: YYYYMMDDHHMMSS

Zwischen (begin) und (end) dürfen maximal sieben Tage liegen.

ja

endEnde des Abfragezeitraumdatestring

Format: YYYYMMDDHHMMSS

Zwischen (begin) und (end) dürfen maximal sieben Tage liegen.

ja
formatRückgabeformatstringcsv (Standard), xml, jsonnein

Rückgabe

  Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.

CSV Format

Metainformationen

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

Spalten

SpalteBeschreibung
DATEGPS Datum wann die Meldung erzeugt wurde YYYY-MM-DD HH:MM:SS
CARFahrzeugkennzeichenstring
SERIALOUTPUTper RS-232 übertragene Datenstring

Beispiel

CSV Format

Code Block
titleRückgabe CSV
"DATE";"CAR";"SERIALOUTPUT"
"2016-05-19 14:30:02";"DD-ABC 123";"PNA|0|000014A5DE88|52|425884|2|*"
"2016-05-19 14:30:05";"DD-ABC 123";"PNA|0|000014A5DE88|52|425884|1|*"
"2016-05-19 14:30:06";"DD-ABC 123";"PNA|0|000014A5DE88|52|425885|2|*"

 XML Format 

Code Block
titleRückgabe XML
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?><!DOCTYPE yfrtiout SYSTEM "https://map.yellowfox.de/rti/dtd/yf_getrs232.dtd">
<yf_getrs232>
   <message>
      <date>2016-05-19 14:30:02</date>
      <car>DD-ABC 123</car>
      <serialoutput>PNA|0|000014A5DE88|52|425884|2|*</serialoutput>
   </message>
   <message>
      <date>2016-05-19 14:30:05</date>
      <car>DD-ABC 123</car>
      <serialoutput>PNA|0|000014A5DE88|52|425884|1|*</serialoutput>
   </message>
   <message>
      <date>2016-05-19 14:30:06</date>
      <car>DD-ABC 123</car>
      <serialoutput>PNA|0|000014A5DE88|52|425885|2|*</serialoutput>
   </message>   
</yf_getrs232>

 JSON Format (RFC 4627)

Code Block
titleRückgabe JSON
[{"date":"2016-05-19 14:30:02","car":"DD-ABC 123","serialoutput":"PNA|0|000014A5DE88|52|425884|2|*"},{"date":"2016-05-19 14:30:05","car":"DD-ABC 123","serialoutput":"PNA|0|000014A5DE88|52|425884|1|*"},{"date":"2016-05-19 14:30:06","car":"DD-ABC 123","serialoutput":"PNA|0|000014A5DE88|52|425885|2|*"}]

Beispielaufrufe

Code Block
titleLiefert per RS-232 übertragene Daten im CSV-Format
https://dev.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=csv

https://dev.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20160519000101&end=20160520130001&format=csv


Code Block
titleLiefert per RS-232 übertragene Daten im XML-Format
https://dev.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=xml

https://dev.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20160519000101&end=20160520130001&format=xml


Code Block
titleLiefert per RS-232 übertragene Daten im JSON-Format
https://dev.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=json

https://dev.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20160519000101&end=20160520130001&format=json


...