...
| Parameter | Beschreibung | Typ | Hinweis | Pflicht | |
|---|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | ||
| vehicle | RTI Fahrzeugschlüssel | string | entweder vehicle oder group oder import werden erwareterwartet | (ja) | |
| group | RTI Gruppenschlüssel | string | entweder vehicle oder group oder import werden erwartet | (ja)ja | |
| import | RTI Importschlüssel | string | alle Fahrzeuge die zur Firma gehören | entweder vehicle oder group oder import werden erwartet | (ja)ja |
| messagetext | string | Maximale Nachrichtenlänge:
| ja | ||
| responsetype | Typ der Antwortmöglichkeit | integer | 1 = Standard (keine vorgegebene Antwort) 2 = Bestätigung erwartet 3 = Ja-/Nein-Antwort erwartet 4 = vorgegebene Antworten ( für Fleet-Displays ab Verion Version 3.0) Standard: 1 | nein | |
| freeresponses | vorgegebene Antwortmöglichkeiten | serialisiertes Array | notwendig für responsetype = 4 | nein | |
| language | Sprache | string | nur für Responsetype 2 und 3 unterstützte Parameter: deu, gbr, ndl, fra, ita Standard: deu | nein | |
| format | Format | string | Format der zurückgelieferten Antwort der Schnittstelle unterstüzte Formate: csv, xml, json Standard: json | nein |
...
Es wird standardmäßig ein JSON-String zurückgegeben, welcher zu jedem Fahrzeug die Auswertung und bei Erfolg auch den SESSIONKEY enthält. Bei fehlenden Pflichparametern wird ein "ERROR:Beschreibung" zurückgegeben
Beispielaufrufe
| Code Block | ||
|---|---|---|
| ||
//normale Nachricht an einzelnes Fahrzeug
http://map.yellowfox.de/rti/do_message.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&messagetext=RTI%20do_message%20test
// Bestätigungsnachricht an Gruppe mit englischer Bestätigung und gewünschten Rückgabeformat als CSV
http://map.yellowfox.de/rti/do_message.asp?company=COMPANY_RTIKEY&group=GROUP_RTIKEY&messagetext=RTI%20do_message%20test&responsetype=2&language=gbr&format=csv
// Ja-Nein-Nachricht an alle mit englischer Bestätigung und gewünschten Rückgabeformat als xml
http://map.yellowfox.de/rti/do_message.asp?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&messagetext=RTI%20do_message%20test&responsetype=3&language=gbr&format=xml
// Nachricht mit Antwortvorlage an alle, mit gewünschten Rückgabeformat als xml und der Antwortvorlage als serialisiertem Array
http://map.yellowfox.de/rti/do_message.asp?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&messagetext=RTI%20do_message%20test&responsetype=4&format=xml&freeresponses=a%3A3%3A%7Bi%3A0%3Bs%3A15%3A%22Verz%F6gerung+2h%21%22%3Bi%3A1%3Bs%3A22%3A%22Habe+Kunden+informiert%22%3Bi%3A2%3Bs%3A18%3A%22Ladung+vollst%E4ndig%22%3B%7D
|
Beispielrückgabe bei mehreren Fahrzeugen
Beispielrückgabe:
| Code Block | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?>
<root>
<message_to>
<car>Car 1</car>
<result>ERROR_HARDWARE_COMBINATION_NOT_SUPPORTED</result>
</message_to>
<message_to>
<car>Car 2</car>
<result>OK</result>
<sessionkey>8f2756f523a8b77877c7c9d1cc454b89</sessionkey>
</message_to>
<message_to>
<car>Car 3</car>
<result>ERROR_HARDWARE_DONT_SHOW_RESPONSETYPE_3</result>
</message_to>
</root>
|
...
| Code Block | ||
|---|---|---|
| ||
"CAR";"RESULT";"SESSIONKEY" "Car 1";"ERROR_HARDWARE_COMBINATION_NOT_SUPPORTED";" " "Car 2";"OK";" " "Car 3";"ERROR_HARDWARE_DONT_SHOW_RESPONSETYPE_3";" " |
Beispiele
| Code Block | ||
|---|---|---|
| ||
http://map.yellowfox.de/rti/do_message.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&messagetext=RTI%20do_message%20test
|
| Code Block | ||
|---|---|---|
| ||
http://map.yellowfox.de/rti/do_message.asp?company=COMPANY_RTIKEY&group=GROUP_RTIKEY&messagetext=RTI%20do_message%20test&responsetype=2&language=gbr&format=csv |
| Code Block | ||
|---|---|---|
| ||
http://map.yellowfox.de/rti/do_message.asp?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&messagetext=RTI%20do_message%20test&responsetype=3&language=gbr&format=xml |
| Code Block | ||
|---|---|---|
| ||
http://map.yellowfox.de/rti/do_message.asp?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&messagetext=RTI%20do_message%20test&responsetype=4&format=xml&freeresponses=a%3A3%3A%7Bi%3A0%3Bs%3A15%3A%22Verz%F6gerung+2h%21%22%3Bi%3A1%3Bs%3A22%3A%22Habe+Kunden+informiert%22%3Bi%3A2%3Bs%3A18%3A%22Ladung+vollst%E4ndig%22%3B%7D
|