- 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 5 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 erwaret | ja |
group | RTI Gruppenschlüssel | string | ja | |
import | RTI Importschlüssel | string | alle Fahrzeuge die zur Firma gehören | ja |
messagetext | 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 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 |
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
Beispielaufrufe
//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
<?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";" "
- No labels