- Created by YellowFox R&D, last modified on Nov 29, 2016
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 8 Next »
You have English selected as language but this page has not been translated yet. Translate the page or view the content in the default space language below.
Display defaultEine Nachricht an ein einzelnes Fahrzeug, eine Gruppe oder alle (import) senden.
Beschreibung
do_message.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&messagetext=Nachricht&language=deu&responsetype=2
Parameter
Parameter | Beschreibung | Typ | Hinweis | Pflicht |
---|---|---|---|---|
company | RTI Firmenschlüssel | string | ja | |
vehicle | RTI Fahrzeugschlüssel | string | entweder vehicle oder group oder import werden erwartet | (ja) |
group | RTI Gruppenschlüssel | string | entweder vehicle oder group oder import werden erwartet | (ja) |
import | RTI Importschlüssel | string | entweder vehicle oder group oder import werden erwartet | (ja) |
messagetext | string | Maximale Nachrichtenlänge:
| ja | |
responsetype | Typ der Antwortmöglichkeit | integer | 1 = keine vorgegebene Antwort (Standard) 2 = Bestätigung erwartet 3 = Ja-/Nein-Antwort erwartet 4 = vorgegebene Antworten ( für Fleet-Displays ab Version 3.0) | 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 (Standard), gbr, ndl, fra, ita | nein |
format | Rückgabeformat | string | Format der zurückgelieferten Antwort der Schnittstelle unterstüzte Formate: csv (Standard), xml, json | nein |
Rückgabewerte
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
Beispielrückgabe:
<?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>
[{"car":"Car 1","result":"ERROR_HARDWARE_COMBINATION_NOT_SUPPORTED"},{"car":"Car 2","result":"OK","sessionkey":"8a810da98bc0583af5959af0e8dde59f"},{"car":"Car 3","result":"ERROR_HARDWARE_DONT_SHOW_RESPONSETYPE_3"}]
"CAR";"RESULT";"SESSIONKEY" "Car 1";"ERROR_HARDWARE_COMBINATION_NOT_SUPPORTED";" " "Car 2";"OK";" " "Car 3";"ERROR_HARDWARE_DONT_SHOW_RESPONSETYPE_3";" "
Beispiele
http://map.yellowfox.de/rti/do_message.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&messagetext=RTI%20do_message%20test
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
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
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
- No labels