Versions Compared

Old Version 26

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version Current

changes.mady.by.user YellowFox R&D

Saved on

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
 getget_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ückgabewerte

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
CARFahrzeugkennzeichen
String
string
SERIALOUTPUTper RS-232 übertragene Daten
String
string

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 "httphttps://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
httphttps://devmap.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=csv

https://map.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
httphttps://devmap.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=xml

https://map.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
httphttps://devmap.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=json

https://map.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


Sv translation
languageen

Get RS-232 data.

Description

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

Parameters

parameter
Parameter
description
Description
type
Type
note
Note
mandatory
Mandatory
companyRTI company keystring
 

yes
vehicleRTI vehicle keystring
 

yes
startstart of intervaldatestring

format: YYYYMMDDHHMMSS

maximal allowed range of 7 days between begin and end

yes

endend of intervaldatestring

format: YYYYMMDDHHMMSS

maximal allowed range of 7 days between begin and end

yes
formatreturn formatstringcsv (standard), xml, jsonno

Return

 Return a string. In case of error "ERROR:Description" will be returned.

CSV format

meta data

delimiter
Delimitersemicolon ( ; )
text
Text delimiterdouble quote ( " )
line
Line end0x0D 0x0A (CarriageReturn LineFeed)
header
Headerfirst line

Columns

column
Column
description 
Description
DATEGPS date when measurement was created YYYY-MM-DD HH:MM:SS
CARlicense
String
string
SERIALOUTPUTRs232 data
String
string

Example

CSV format

Code Block
titlereturn in 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
titlereturn in xml
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?><!DOCTYPE yfrtiout SYSTEM "httphttps://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
titlereturn in 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|*"}]
Examples

Example calls

Code Block
titlereturn RS-232 data in CSV-format
httphttps://devmap.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=csv

https://map.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
titlereturn RS-232 data in XML-format
httphttps://devmap.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=xml

https://map.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
titlereturn RS-232 data in JSON-format
httphttps://devmap.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=json

https://map.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