You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 4
Next »
No Translation available yet
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 default
Eine 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: - CE-Displays + Android Fleet: 500 Zeichen
- Alle anderen Displays: 200 Zeichen
| 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 die 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 serialisiertes 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